Prerequisites
Use the repository’s pnpm version (packageManager in the root manifest), a supported Node runtime (CI uses Node 24), Git and a local Postgres installation for integration tests.
Install the workspace
sh pnpm install --frozen-lockfileConfigure the project
sh pnpm setup pnpm doctorSetup covers identity, environment files and the selected database/Cloudflare providers. For an existing clone, preserve its identity and credentials and repair only missing configuration.Apply migrations and start
sh pnpm db:migrate pnpm dev:web
Local runtime
The web dev server defaults to port 3005 and uses Nitro/Node, not workerd. The production build uses the Cloudflare plugin. A successful dev request alone does not validate Worker compatibility. Use the built-Worker checks for changes to server dependencies.
Parallel worktrees need separate ports and isolated databases. Set an explicit dev-server port and stop only processes you started. Do not run migrations against another lane’s database.
Common setup failures
Missing credentials belong in the correct environment file. A database history mismatch needs investigation, not db:push. Start with pnpm doctor and the existing setup skill before manually rewriting project identifiers.