Skip to main content

For platform teams

Documentation for engineers who deploy, configure, and operate Constellation OS infrastructure.

Operators should start with Your first session.

Public surfaces

SurfaceURL
Consoleconsole.constellation.space/app/
Knowledge Basedocs.constellation.space
Marketingconstellation.space

Console and Knowledge Base share a CloudFront distribution in production; hostnames route to /app/ or docs root respectively.

Infrastructure

  • AWS CDK in infra/ — SSM parameters, S3, CloudFront, Cognito
  • GitHub Actions — console, docs, and marketing deploy workflows

Release flow

  1. Merge to main
  2. Console: dev → staging → production
  3. Knowledge Base: build → S3 sync → CloudFront invalidation
  4. Marketing: static export to production bucket

One-time setup

npm install
npm run deploy:infra

Configure GitHub Environments (dev, staging, production) — see .github/ENVIRONMENTS.md.