VillageSim starter

A minimal local-first app shell for the VillageSim MVP.

This scaffold wires up the Next.js + React + TypeScript foundation so the UI, backend, and worker tracks can land on a runnable base without revisiting project setup.

Open demo town target Next.js docs

What is included

Next.js App Router with global styling and a starter home screen.
Baseline scripts for development, production build, runtime start, and linting.
Mock-friendly environment defaults for local-first iteration before real services exist.

Recommended first run

Copy .env.example to .env.local and keep VILLAGESIM_PLANNER_MOCK=true for a local-first first run.
Install dependencies, then start the Next.js shell with npm run dev.
Use the demo town route as the handoff target for the town renderer and backend tracks.

The /town/demo-town route now uses shared mock village state and can be advanced through the local tick API or worker script.