City Monorepo

TypeScript + React + Turborepo scaffold for the SimCity-style port.

Requirements

• Node.js >= 24
• pnpm >= 10.28 (Corepack recommended)

Getting started

corepack enable
pnpm install
pnpm dev

Workspace layout

• apps/web: Vite + React app using TanStack Router (file-based routes live in src/routes)

Common commands

pnpm dev
pnpm build
pnpm lint
pnpm typecheck
pnpm test
pnpm format

Autonomous task orchestration

The repo includes a Codex-driven orchestrator at scripts/auto-orchestrator.mjs for the staged playable-game rollout plans:

• STAGE_0_CONTRACT_FREEZE_PLAN.md
• STAGE_1_MOCKED_BRIDGE_PLAN.md
• STAGE_2_SIMPLE_UI_PLAN.md
• STAGE_3_REAL_BRIDGE_DO_PLAN.md
• STAGE_4_GLUE_AND_PLAYABLE_PLAN.md

Inspect queue + drift:

pnpm auto:queue
pnpm auto:drift

Run unattended (default runtime cap: 24 hours):

pnpm auto:run -- --max-runtime-minutes 1440

Useful flags:

• --once: complete exactly one task and stop.
• --dry-run: plan/selection only; no git push or PR changes.
• --streams <id,...>: run only specific stage stream ids (stage-0 ... stage-4).
• --no-tests: remove pnpm test from --checks if present.
• --max-retries-per-task <n>: retries before a task is marked blocked.
• --model <name>: pass a specific model to codex exec.

The orchestrator stores state/logs in .automation/. Create .automation/STOP to halt the loop after the current iteration.

Turborepo remote caching

Remote caching is ready to wire up when you want it:

pnpm dlx turbo login
pnpm dlx turbo link

Then set TURBO_TOKEN and TURBO_TEAM in CI secrets.

Notes

• routeTree.gen.ts is generated by the TanStack Router Vite plugin and is ignored by git.
• Commit pnpm-lock.yaml after your first install; CI expects a lockfile.