Deployment Progress and Success
This guide describes the deployment progress page (stages, logs, cancel, redeploy) and the success page you see after a deployment completes.
When You See the Progress Page
After you trigger a deployment from the site overview (or after a rollback), you are redirected to the progress page:
- URL:
/apps/spad/{site-uuid}/progress?deployment={deployment-uuid}
The progress page shows the current deployment's status, stages, and live logs.
Deployment Stages
A deployment runs through these stages in order:
| Stage | Description |
|---|---|
| Queued | Deployment is queued and waiting to start |
| Preparing | Build environment is being prepared |
| Launching | The build runner (ECS/Fargate) is launching |
| Cloning | Repository is being cloned |
| Installing | Dependencies are being installed (e.g. npm install) |
| Building | Build command is running (e.g. npm run build) |
| Uploading | Built files are being uploaded to S3 |
| Deploying | CloudFront cache is being invalidated |
The UI shows which stage is active and a progress percentage. When the deployment finishes, the status becomes Succeeded, Failed, or Cancelled.
Logs
- Live logs - Build and deployment logs stream on the page. New lines appear as the deployment runs.
- Auto-scroll - The log area typically auto-scrolls to the latest line.
- Use logs to debug failures (e.g. build errors, missing dependencies, wrong output directory).
Actions During a Deployment
| Action | Description |
|---|---|
| Cancel | Stop the deployment before it completes. The deployment status becomes Cancelled. |
| Redeploy | After a deployment has finished (succeeded or failed), run the same deployment again. |
Terminal States
When the deployment is finished, it reaches a terminal state:
| Status | Description |
|---|---|
| Succeeded | Build and deploy completed. Your site is updated. |
| Failed | Build or deploy failed. Check the logs for the error. |
| Cancelled | The deployment was cancelled. No changes were applied. |
On Succeeded, the app may show a short celebration and a toast; you can then go to the Site Dashboard or open the Success page if linked.
Success Page
After a successful deployment, you may land on or open a success page that shows:
- Your site is live - Confirmation that the site is deployed and accessible
- Live URL - The CloudFront (or primary) URL for the site. You can copy it or click Open Site
- Links - Site Dashboard (back to site overview), Open Site (open the URL), Settings (site settings)
When Rollback Uses the Progress Page
When you roll back to a previous deployment, a new deployment is created (re-deploying that revision). You are redirected to the progress page for that new deployment. When it Succeeded, the site is serving the rolled-back revision.
