Deployment

The Admin dashboard is a static SPA deployed to S3 and served via CloudFront CDN. There is no server or container to manage.

Build

cd apps/admin
npm run build

Output is written to apps/admin/dist/.

Deploy via CDK

The CDK Admin Stack reads the build output and syncs it to S3:

cd infrastructure/aws
npm run cdk deploy admin-hosting

Set ADMIN_BUILD_PATH in infrastructure/aws/.env if your build output path differs from the default (apps/admin/dist).

CloudFront configuration

The CDK stack configures CloudFront to return index.html for all paths, enabling client-side routing to work correctly for deep links.

Static assets are cached with long TTLs. After deploying a new build, the CDK stack automatically creates a CloudFront invalidation to clear the cache.

Custom domain

ADMIN_DOMAIN_ENABLED=true
ADMIN_DOMAIN_NAME=admin.example.com
DOMAIN_HOSTED_ZONE_NAME=example.com

CDK will provision an ACM certificate and associate it with the distribution.