dashersw/coyopedal/editing-the-gea-ui

The Gea UI

A single TypeScript/JSX app runs on both targets. The web build uses Vite and @geajs/core. On the ESP32, @geastack/compiler lowers it to native C++, and there is no JS VM.

Map

Adding a board call

Add it in three places: the type in src/ui/board.ts, the fixture in src/preview/, and the native side in board_bridge.cpp. Also declare it in scripts/panel-host-plugin.mjs if the plugin enumerates it. Keep the store the only caller.

Seeing it

• npm run dev starts the Vite server. .claude/launch.json defines dev on port 3000, so use

the preview tools with that name. The layout fills the viewport width with fixed-size text and a minimum height of 205 logical px. The preview width selector covers 251 px (2.06), 300 px (landscape 2.41), 480 px and fit-window; preview zoom is 2×. Board key 3 is the logical viewport width used by slider hit testing.

• npm run preview:panel writes build/ui-preview/.
• node --test tests/gea-store.test.mjs and npm run check:frontend.
• npm run build:firmware is the only check of the native lowering. Compilation must keep

dynamic fallback disabled.

Don'ts

• Don't edit generated C++ or rasterised assets under .gea/build/.
• Don't add a JS runtime, a second compiler invocation, a local panel/display component or the

old hand-written screen renderer.

• Don't enable Gea's own network services. Wi-Fi and BLE belong to the maintenance service.
• The browser preview doesn't show device frame rate, PSRAM headroom or audio impact.

UI boot has caused audio misses before (see measuring-pedal-audio).

• Fonts: assets/fonts/Saira-Bold-Pedal.otf, Saira Bold with icon glyphs drawn in by

node tools/font_glyphs.mjs (edit its GLYPHS table and rerun). The panel only has printable ASCII and a short list of extra codepoints (embeddedFontExtraCodepoints in @geastack/core); icons are glyphs drawn there (‹ › are chevrons). Don't use SVG, images or rotated borders for icons. Public asset paths must be literals so both Vite and the embedded asset linker resolve them.