Deployment
ShockStack supports frontend-focused deployment and full-stack container deployment.
Deployment Targets
- Frontend runtime deployment
- Containerized full-stack deployment
Choose based on whether you need only the web app or the complete API/database stack.
Required Environment Variables
| Variable | Scope | Purpose |
|---|---|---|
DATABASE_URL | App | Database connection |
BETTER_AUTH_SECRET | App | Session/auth signing secret |
BETTER_AUTH_URL | App | Public application URL |
CLOUDFLARE_API_TOKEN | CI/CD | Frontend deployment credentials |
CLOUDFLARE_ACCOUNT_ID | CI/CD | Frontend deployment account |
ConnectionStrings__DefaultConnection | Backend | Backend database connection |
Cors__Origins__0 | Backend | Allowed frontend origin |
Typical Frontend Deploy Flow
- Build design tokens
- Build frontend artifacts
- Publish runtime bundle with deployment CLI/tooling
Typical Full-Stack Deploy Flow
- Build and tag backend container image
- Push image to container registry
- Deploy runtime with environment variables and secrets
- Run health checks and rollout verification
CI/CD Behavior
- CI runs lint, typecheck, test, and build tasks
- Release automation publishes changelog/tag artifacts
- Deploy automation can publish frontend and backend independently
Rollout Checklist
- Validate env vars/secrets are set in target environment
- Confirm database connectivity before cutover
- Verify readiness/liveness endpoints after deploy
- Confirm auth flow works end-to-end in production URL