Console environments

Each console environment is a static build synced to an S3 bucket fronted by CloudFront.

Default mapping

Environment	CloudFront alias	S3 bucket (default)
dev	dev-console.constellation.space	constellation-dev-docs-website
staging	staging-docs.constellation-io.com	constellation-staging-docs-website
production	console.constellation.space	constellation-prod-docs-website

Console assets are served under /app/ on these distributions (shared with legacy docs buckets).

Build-time configuration

Per-environment Vite env (from SSM in CI):

• VITE_COGNITO_* — OAuth client and redirect URIs
• VITE_CONSTELLATION_API_URL — optional direct API override
• Chat and billing Lambda URLs

Example production redirect:

https://console.constellation.space/app/oauth/callback

CI workflow

.github/workflows/deploy-console-app.yml:

1. Read config from SSM /constellation/web/console/
2. Build apps/console-app
3. aws s3 sync to environment bucket under /app/
4. CloudFront invalidation for /app/*

GitHub variables (optional overrides)

Variable	Example
CONSOLE_DEV_ALIAS	dev-console.constellation.space
CONSOLE_PROD_ALIAS	console.constellation.space
CONSOLE_PROD_CF_DISTRIBUTION_ID	Distribution ID

Primary source of truth after CDK deploy: SSM.

Manual deploy

npm run deploy:console:dev -w constellation-os-app
npm run deploy:console:prod -w constellation-os-app

Requires AWS credentials and populated SSM parameters.