Local development

Prerequisites

Node.js 24 LTS (see engines in package.json)
npm 10+
PostgreSQL for portal login and product features (DATABASE_URL in .env.example)

Main app

cp .env.example .env   # set DATABASE_URL and server auth secret (see .env.example)
npm install
npm run db:migrate     # requires real DATABASE_URL
npm run dev            # http://localhost:3000

Companion apps

npm run dev:talent      # port 3002
npm run dev:contractor  # port 3003

Copy the Talent and Contractor .env.example files; align the server auth secret and database URL with the main app for shared sessions.

Quality gates

Command	Purpose
`npm run typecheck:all`	TypeScript (main + apps)
`npm run lint`	ESLint (root; `npm run lint:apps` for Talent/Contractor)
`npm run test:unit`	Node policy/unit tests
`npm run security-check`	Lint and dependency checks

Documentation content

Public docs are stored in content/docs.json and editable in Admin → Resources → Docs. Published pages are server-rendered at /resources/docs/[slug] until the /docs route ships.

Prerequisites

Node.js 24 LTS (see engines in package.json)
npm 10+
PostgreSQL for portal login and product features (DATABASE_URL in .env.example)

Main app

cp .env.example .env   # set DATABASE_URL and server auth secret (see .env.example)
npm install
npm run db:migrate     # requires real DATABASE_URL
npm run dev            # http://localhost:3000

Companion apps

npm run dev:talent      # port 3002
npm run dev:contractor  # port 3003

Copy the Talent and Contractor .env.example files; align the server auth secret and database URL with the main app for shared sessions.

Quality gates

Command	Purpose
`npm run typecheck:all`	TypeScript (main + apps)
`npm run lint`	ESLint (root; `npm run lint:apps` for Talent/Contractor)
`npm run test:unit`	Node policy/unit tests
`npm run security-check`	Lint and dependency checks

Documentation content

Public docs are stored in content/docs.json and editable in Admin → Resources → Docs. Published pages are server-rendered at /resources/docs/[slug] until the /docs route ships.