Frothy
Home Guide
Guide

Guide

Learn Frothy from the first prompt through definitions, control flow, hardware, persistence, and extension.

This guide starts at the prompt and moves outward. It is for learning the shape of Frothy, not memorizing every word.

The path is:

  1. get one visible result
  2. name small behaviors
  3. change them live
  4. keep state deliberately
  5. save what works
  6. reach for hardware and C only when the project needs them

If you have not built the CLI or flashed a board yet, start with Install .

  1. 01 01. What Frothy Is The core mental model: stable slots, lexical code, and a live image. 4 min
  2. 02 02. Getting Started Your first live session: connect, evaluate small expressions, inspect names, and blink the built-in LED. 6 min
  3. 03 03. Values and Expressions Values, calls, grouping, and left-to-right evaluation. 5 min
  4. 04 04. Words and Definitions Define callable Code values, choose a house style, and understand coherent redefinition. 7 min
  5. 05 05. Locals, Names, and State Lexical locals, explicit mutation, and top-level Cells. 6 min
  6. 06 06. Blocks and Control Flow Use blocks as lexical scopes and Code values; choose, repeat, and loop with explicit booleans. 7 min
  7. 07 07. Errors and Recovery Recoverable runtime errors, interrupts, safe boot, inspection, and getting back to a usable prompt. 6 min
  8. 08 08. Text and I/O Text literals, byte-oriented indexing, prompt output, and the split between language values and board I/O. 5 min
  9. 09 09. Talking to Hardware Use the ESP32 board layer: LED, GPIO, ADC, timing, and lower-level peripherals when needed. 7 min
  10. 10 10. Snapshots and Persistence Save the overlay image, restore it, wipe it, and understand what does not persist. 5 min
  11. 11 11. Where to Go Next Move from the guide into tutorials, reference, hardware, or FFI. 2 min
Advanced
  1. 12 12. FFI and C How C bindings enter the base image, when to use project FFI, and what the value boundary allows. 9 min