Deployment

Everything is Docker Compose + Caddy. No cluster.

Layout

~/sphere-dashboard/
├── compose.yaml                     # all services
├── Caddyfile                        # path routing
├── certs/                           # self-signed (gitignored)
├── dashboard/                       # static landing
│   ├── Dockerfile                   # nginx:alpine
│   └── site/
├── whitepaper/dist/                 # built from ~/sphere-whitepaper
├── docs/dist/                       # built from ~/sphere-docs
└── demos/dist/                      # built from ~/sphere-demos

Path routing

Path	Service
`/`	`dashboard`
`/landing`	`dashboard`
`/whitepaper/*`	`whitepaper` (nginx static)
`/docs/*`	`docs` (nginx static)
`/demos/*`	`demos` (nginx static)

Build cycle

# Whitepaper
cd ~/sphere-whitepaper && npm run build
rsync -a --delete dist/ ~/sphere-dashboard/whitepaper/dist/

# Docs
cd ~/sphere-docs && npm run build
rsync -a --delete dist/ ~/sphere-dashboard/docs/dist/

# Demos
cd ~/sphere-demos && ./build.sh
rsync -a --delete dist/ ~/sphere-dashboard/demos/dist/

# Reload Caddy + (re)build static containers
cd ~/sphere-dashboard && sg docker -c "docker compose up -d --build"

(See ~/sphere-dashboard/scripts/deploy.sh once that exists.)