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 Learn the values Frothy carries, how calls read, and how expressions group. 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 to choose, repeat, loop forever, and react to events. 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 extending Frothy. 2 min
Advanced
  1. 12 12. Libraries and Native Words How libraries enter a Frothy project, and when a library should add C. 4 min