Skip to main content

​
Prerequisites

  • Node.js and pnpm (the repo uses pnpm exclusively — never npm or yarn at the root)
  • Docker for the local PostgreSQL instance

​
Install

pnpm install

​
Start the database

A local Postgres runs via Docker Compose on port 5433: 
docker compose up -d
Then apply migrations from apps/server: 
cd apps/server
pnpm db:migrate

​
Run the apps

# All apps in parallel
pnpm dev

# Or individually
pnpm web      # Vite dev server on port 5173
pnpm server   # Express via tsx watch

​
Checks before pushing

pnpm --filter web typecheck
pnpm --filter web lint
Railway runs npx tsc during deploy, so type errors that only show up in the IDE will still fail the build. Always run the server typecheck before pushing.