Local development
Run the dev server, hot reload, environment setup, and debugging tips for Simulacrum-generated projects.
Dev server
bash
npm install
npm run dev
The default listens on http://localhost:3000. Turbopack or webpack follows your generated package.json scripts.
Environment files
Copy .env.example to .env.local and fill database URLs, auth secrets, and payment test keys. Restart the dev server after changing env vars.
Hot reload
App Router routes and client components hot reload. Server-only modules may require a full refresh when you change singleton initialization.
Typecheck and lint
bash
npm run lint
npx tsc --noEmit
Run these before opening a pull request; CI templates mirror the same commands.
Never point a local .env.local at production databases. Use branch databases or local Postgres/SQLite per adapter docs.