Skip to main content

Local setup

Constellation is a Turborepo monorepo using npm workspaces. Node 20+ required.

Install​

git clone https://github.com/B2B-Online/constellation.git
cd constellation
npm install

Start the dev services​

The apps need a local PostgreSQL (shared by all modules) and MinIO (for storage).

npm run dev:services       # starts PostgreSQL + MinIO in Docker
npm run db:migrate         # applies all module migrations

Run an app​

npm run dev:dir            # Directory on :3001
npm run dev:pt             # Project Tracker on :3002
# or
npx turbo dev --filter=@constellation/catalog

Full CI pipeline locally​

Before every push:

npx prettier --check "**/*.{ts,tsx,js,jsx,json,md}"
npx turbo run lint typecheck build test
npm run check:routes

See the root CLAUDE.md for the full checklist.

Troubleshooting​

  • psql not found — on macOS set PSQL_PATH=/usr/local/bin/psql in your .env.local.
  • Prisma client out of date — run npx turbo db:generate.
  • Port already in use — the dev:services Docker compose binds default ports; stop conflicting processes or edit docker-compose.dev.yml.