Reference — Frothy

Home Reference

Reference

Exact behavior for the Frothy language, word catalog, hardware words, device sessions, persistence, and toolchain.

Use the reference when you need the exact surface rather than the teaching arc. If you are new, start with Install or Getting Started first.

The main sections are:

Start with Frothy in ten minutes for the shortest complete pass through the language
Language for exact syntax and runtime semantics
Word catalog for one entry per word, form, constant, and prompt-facing built-in
Hardware for ESP32 board words and peripheral surfaces
Device & sessions for REPL behavior, diagnostics, persistence, boot, and recovery
Toolchain for CLI, project/build files, flashing, source files, and editor support
Extending for libraries, dependency manifests, and native words
Porting for bringing Frothy to a new MCU by implementing one platform header

Exact syntax and runtime semantics for Frothy values, calls, definitions, control flow, records, errors, events, and comments.

Canonical lookup entries for Frothy words, forms, constants, and prompt-facing built-ins.

ESP32 board words for GPIO, ADC, timing, UART, I2C, PWM, and Bluetooth Low Energy.

Prompt sessions, control sessions, diagnostics, persistence, boot, and recovery on a Frothy device.

Use libraries, write pure Frothy libraries, and add native words when C is required.

CLI, project/build files, flashing, sending source, and editor integration.

Bring Frothy to a new MCU by implementing one platform header.

A one-page pass through the Frothy language, from prompt basics to saved hardware code.