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. Native development additionally needs the platform toolchain and a compatible Expo development client.
Install the workspace
pnpm install --frozen-lockfileConfigure the project
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
pnpm db:migrate pnpm dev:web # In another terminal, when needed: pnpm dev:mobile
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, adjust the public server URL used by mobile, 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 stale development client needs rebuilding after native dependency changes. A database history mismatch needs investigation, not db:push. Start with pnpm doctor and the existing setup skill before manually rewriting project identifiers.