Testing And CI

This page explains the checks that protect production quality.

API CI

Workflow: .github/workflows/api-ci.yml

It runs:

• build + type checks
• lint + formatting checks
• unit tests
• infra-backed E2E subset
• calendar perf gate suite (test:e2e:perf)

Docs CI

Workflow: .github/workflows/docs-ci.yml

It verifies docs build successfully.

Run locally

From repo root:

npm run docs:sync
npm run docs:build
npm run docs:check

From api/:

npm run test:e2e:infra
npm run test:e2e:perf

Notes:

• test:e2e:infra starts/stops mongo + redis via docker compose.
• Avoid running test:e2e:infra and test:e2e:perf in parallel locally because both jobs manage the same local containers.