Skip to main content

Development

Setup

cp .env.example .env
pip install ".[dev]"
cd apps/web
npm ci
cd ../..
./scripts/dev.sh infra
./scripts/dev.sh init

Run services:

./scripts/dev.sh api
./scripts/dev.sh web
./scripts/dev.sh worker

Tests

make test
make test-regression
make test-e2e
make test-all

The default test target excludes slow, manual, network, Docker, and cloud-marked tests.

Frontend

cd apps/web
npm ci
npm run dev
npm run build

Style

Python is checked with Ruff. TypeScript uses strict mode.

make lint
make format

Contributions

See CONTRIBUTING.md in the repository root. Keep changes focused, add tests for behavior changes, and update docs when setup or user-facing behavior changes.