Constellation developer documentation
Constellation is a multi-tenant platform for building secure B2B collaboration apps. This site is the developer documentation — architecture invariants, module references, the API surface, and the operations playbook. It is not a product page. If you are running the platform or shipping code into it, you are in the right place.
System context
Same diagram lives in Architecture overview, where it's followed by the C4 L2 (Container) view.
I'm new here — first 30 minutes
- Local setup — clone, install, run services, start a module. ~10 minutes.
- Architecture overview — system shape, source layout, the C4 diagrams, the six core invariants. ~10 minutes.
- Request lifecycle — one annotated trace from the browser to Postgres and back, with the rule each layer enforces. ~10 minutes.
After that, pick a module and read its overview page.
I'm an AI agent — reference surface
Cite these by URL — every anchor is slug-stable and the build fails on broken internal links, so URLs saved today are durable.
- Rules & invariants — the 10 platform invariants every change must respect, each with a stable slug-anchor (
#tenant-context,#route-wrapping,#audit-critical, …). - Glossary — 30 Constellation-specific terms with stable anchors (
#tenant,#deliverable,#outbox, …). - Domain events index — every event published by every module (59 total), each row linking to the Zod schema in source.
- Project Tracker API — auto-generated from the Zod schemas in
apps/project-tracker/src/lib/openapi.ts.
The Task router in AGENTS.md maps common agent tasks to the specific files to read first plus the rule anchors to apply.
Modules
| Module | Surface |
|---|---|
| Directory | Identity, organisations, users, roles, permissions, locale |
| Catalog | Product information management, taxonomy, semantic search, AI enrichment |
| Project Tracker | Programmes, projects, tasks, issues, stage-gates, deliverables |
Where to find what
| Looking for | Go to |
|---|---|
| Live execution status | Project Tracker dogfood instance |
| Operations playbook | Deployment, Release flow |
| Shared platform packages | Shared packages overview |
| Changelog | Root CHANGELOG.md |
| Binding rules for contributors | Root AGENTS.md and CLAUDE.md |
| Multilanguage / i18n | Multilanguage spec |
Search
Use the navbar search input or Cmd/Ctrl+K to query across every page. Index is built offline at deploy time — no telemetry leaves the browser.