#Local Development

Run frontend, backend, and runtime together for complete local testing.

#Recommended Local Stack

1. Backend API process.
2. Frontend web app process.
3. ShellRunners runtime process.

#Typical Startup Order

1. Start backend and verify health endpoint.
2. Start runtime service and verify runtime route loads.
3. Start frontend and verify game page can reach runtime and backend.

#Useful Local Checks

1. Identity registration path.
2. Auth nonce/verify path.
3. Session start and live list path.
4. Snapshot/readiness/payout path.
5. Market listing helper and visibility path.

#Quality Gates

1. Lint.
2. Typecheck.
3. Build.
4. Contract tests where relevant.

#Local Debug Advice

1. Check backend logs first for auth/session/payout failures.
2. Confirm frontend is using expected API base.
3. Confirm runtime receives and uses valid play/spectate tokens.