Ebonkeep

High-level implementation planning docs live in docs/, starting with docs/00-index.md. Repository-specific Codex instructions live in AGENTS.md.

Development Foundation

Monorepo structure:

• apps/api - Fastify + Zod backend modular monolith scaffold.
• apps/web - React + Vite web client scaffold.
• apps/desktop - Electron desktop wrapper scaffold.
• packages/shared - shared contracts and schemas.
• infra/docker - local Postgres, Redis, and observability compose stack (Prometheus, Loki, Grafana).

Local Run (Windows)

1. Run run-local.bat from repo root.
2. Open web at http://localhost:5173.
3. Use the in-app guest login and load player state.
4. Stop everything with stop-local.bat.

Android emulator:

• Run run-android-emulator.bat to launch the default AVD, or run-android-emulator.bat <AVD_NAME> to launch a specific one.
• In the emulator, use http://10.0.2.2:5173 for the web app and point frontend API/WebSocket env vars at 10.0.2.2.
• Use run-local-android.bat to start the local stack with emulator-safe web env values.

See:

• docs/dev-setup.md
• docs/local-runtime.md
• docs/android-testing.md