StackChan Codex Pet / Stackdex MVP

Stackdex is a StackChan / M5Stack CoreS3 Codex companion MVP. It includes visual assets, a Mac Gateway, a Web Simulator, and a PlatformIO firmware startup demo.

Highlights

• 12 animation states × 8 frames each
• direct-use 320x240 PNG frames
• RGB565 little-endian .bin files
• icon packs
• persistent 5H / 7D UI components
• StackChan handoff docs
• PlatformIO + M5Unified quick-start
• ESP-IDF startup skeleton
• FastAPI Gateway MVP
• Web Simulator MVP

Most important files

• assets_manifest.json
• docs/ASSET_HANDOFF.md
• docs/STACKCHAN_ENGINEERING_STARTUP.md
• docs/ENV_AND_PYTEST_REPRO.md
• docs/FUNCTIONAL_REVIEW_CHECKLIST.md
• docs/FIRMWARE_ASSET_INTEGRATION.md
• docs/INSIGHTS_IMPLEMENTATION.md
• gateway/README.md
• web_simulator/README.md
• startup/platformio_arduino/README.md
• startup/espidf/README.md

Quick Start

Gateway:

gateway/.venv/bin/uvicorn gateway.app.main:app --host 127.0.0.1 --port 8787

Web Simulator:

python3 tools/sync_web_assets.py
cd web_simulator
npm start

Open:

http://127.0.0.1:5173

Gateway demo sequence:

gateway/.venv/bin/python gateway/scripts/demo_sequence.py

Firmware assets and build:

python3 tools/prepare_platformio_assets.py
PLATFORMIO_CORE_DIR=/Users/bou/Workspace/Viber/Stackdex/.platformio-core /Users/bou/.platformio/penv/bin/pio run -d startup/platformio_arduino

Verification

python3 tools/run_acceptance.py

The full acceptance runner writes:

reports/acceptance/stackdex_acceptance_latest.html
reports/acceptance/stackdex_acceptance_latest.json
docs/NEXT_IMPLEMENTATION_PLAN.md

Lower-level checks:

gateway/.venv/bin/python -m unittest discover gateway/tests -v
cd web_simulator && npm test

The Web Simulator contract tests fail if the persistent 5H usage bar is missing from any MVP state.