Site Overview and Deployments
This guide describes the site detail page: status, infrastructure, triggering a deploy, viewing deployments, and rollback.
Opening a Site
- From the Cloud Deploy list (
/apps/spad), click a site name or row - You land on the site detail page (
/apps/spad/{site-uuid})
The page shows the site name, status, deploy URL, custom domains, infrastructure status, deployment stats, and the deployments list.
Site Status
The header shows the current site status:
| Status | Description |
|---|---|
| Provisioning | Infrastructure (S3, CloudFront) is being created. You cannot deploy yet. |
| Active | Site is ready. You can trigger deployments and add custom domains. |
| Failed | Infrastructure provisioning failed. Use Retry or Check (see below). |
Infrastructure
When the site is Provisioning or Failed, a banner or sidebar shows infrastructure state and actions:
- Retry - Restart infrastructure provisioning after a failure
- Check - Open a modal showing the infrastructure plan/state
- Refresh / Reconcile - From the Check modal, trigger a reconciliation of specific components
When infrastructure is ready, the site becomes Active and you can deploy.
Deploy URL and Custom Domains
- CloudFront URL - Each site gets a default CloudFront URL (e.g.
https://xxx.cloudfront.net). Use Open Site in the header to open it. - Custom domains - If you add custom domains (see Custom Domains), they appear in the site header.
Triggering a Deployment
Ensure site is Active
Verify the site status is Active before deploying.
Click Deploy
Click the Deploy button in the header (or the deploy action in the deployments section).
View progress
A new deployment starts and you are redirected to the progress page.
Deployments List
The deployments list shows recent deployments with:
| Column | Description |
|---|---|
| Status | Succeeded, Failed, Cancelled, or In progress |
| Source | Branch, tag, or commit |
| Duration | How long the deployment took (when finished) |
| Time | When it was triggered |
Actions:
- View (or View progress) - Open the progress page for that deployment
- Rollback - Roll back the live site to that deployment
Deployment stats (total, successful, failed, average duration) are shown above the list.
Rollback
Rollback replaces the current live content with the content from a previous successful deployment.
Find a successful deployment
In the deployments list, find a succeeded deployment you want to roll back to.
Click Rollback
Click Rollback (or the rollback action) for that deployment.
Confirm rollback
In the rollback modal, optionally enter a reason and confirm.
Wait for completion
A new deployment is created (re-deploying that earlier revision). You are redirected to the progress page for that deployment.
When it finishes successfully, the site will be serving that revision.
Deployment Polling and Notifications
When the site is Active, the app may poll for new deployments (e.g. from GitHub webhooks). If a new deployment is detected, a notification can appear with a link to View progress.