Local development

Install the monorepo, start Postgres and the API, and run focused apps and tests.

Prerequisites

Node.js 22.12 or newer.
pnpm 10.8.0 through Corepack.
Docker for local Postgres.

Install

corepack enable
pnpm install

Start the database and API

pnpm pg:up
pnpm pg:migrate
pnpm dev:api

The API worker defaults to local configuration and exposes /health, /openapi.json, and /docs.

Run focused applications

pnpm dev:app
pnpm dev:web
pnpm --filter @delulu/docs dev
pnpm cli -- --help

The docs site runs on http://localhost:3004.

Validate

pnpm typecheck
pnpm test
pnpm check

Database-backed integration tests require DATABASE_URL and the local migrations. See apps/api/README.md for worker secrets and deployment bindings.

Troubleshooting

Use Node 22 or newer; the docs toolchain requires Node 22.12.
A production migration must receive a valid PostgreSQL URL, not a shell placeholder or a URL with an incorrect database password.
Missing optional provider secrets disable those integrations but should not change typed contracts.