Sources & Evidence

Historical development context

The archive was assembled after reading two local Codex development tasks: one covered the web game, v5 art, round-screen interaction and migration handoff; the other covered hardware lock, firmware, measured performance, RTC/NVS, interaction fixes and acceptance. Local task identifiers are intentionally excluded from the public site.

Thread narratives provide context; verifiable numbers come from frozen repository documents, source, test output and Git records.

Authoritative repository documents

Path	Purpose
docs/game-design-framework.md	Initial systems and round-screen framework
docs/asset-inventory.md	v5 assets, palette, fonts and quality gates
docs/esp32-migration-handoff.md	Frozen Web → ESP32 contract and milestones
docs/v6-oled-device-milestone.md	Battery, settings, ambient and v6 device contract
docs/web-v7-interaction-contract.md	v7 hold, tilt and gesture contract
docs/esp32-v7-update-handoff.md	Incremental v7 firmware migration
pocket-star/firmware/docs/hardware-lock.md	BOM, pins, addresses and software versions
pocket-star/firmware/docs/device-validation.md	v6 physical validation
pocket-star/firmware/docs/device-validation-v7.md	v7 device, IMU, power and save validation

Core source

• src/core/: state, economy, progression, geometry, saves and TypeScript golden snapshots.
• src/ui/: Canvas renderer, circular layout, gestures, particles, frame FX, bitmap fonts and device runtime.
• projects/bit_orbit_minimal_32x32_20260814/: asset sources, exports, contact sheets and generation specs.
• pocket-star/firmware/pocket-star/main/: C++ game core, rendering, device services and generated assets.
• pocket-star/firmware/tests/: economy, interaction, incremental frames, OLED, audio, IMU, power and save tests.

Upstream

• POCKET STAR / Cookie32 repository
• Waveshare ESP32-S3-Touch-AMOLED-1.75 Wiki
• Waveshare hardware repository
• Waveshare BSP 3.0.1
• ESP-IDF Programming Guide
• VitePress guide
• Fusion Pixel Font, SIL OFL 1.1.

Media generation

The twelve GIFs are deterministic assemblies of frozen fx_tap / fx_grow / fx_loop / core_idle / core_sleep frames and historical screenshots:

python3 -m pip install -r website/requirements.txt
npm run docs:media

Generated media lives in public/docs-assets/; the VitePress build does not require Python and requests no third-party font CDN.

Evidence rules

1. Prefer source and validation reports over measurements estimated from screenshots.
2. Never invent a commit for a historical working-tree state.
3. Automated logs cannot replace eyes, fingers or ears.
4. Board capability does not equal implemented project behavior.
5. Historical GIFs explain behavior and are not presented as original game assets.