Development

Prerequisites

• ESP-IDF v5.5+
• mise for tool management
• One of the supported boards

Build and Flash

The project uses scripts/idf.sh to handle board selection and build directories. Mise tasks provide convenient shortcuts:

# JC8012P4A1C (large, 800x1280) — default board
mise run esp build flash monitor

# JC4880P443C (small, 480x800)
mise run esp-small build flash monitor

# JC1060P470C (medium, 1024x600)
mise run esp-medium build flash monitor

Or use the script directly:

scripts/idf.sh jc8012p4a1c build flash monitor

Development Workflow

1. Make changes to shared code in shared/
2. Test quickly with the desktop simulator
3. Build and flash to hardware when ready