Deployments
The Deployments screen shows the workflow runs for the active branch and gives you controls for triggering, cancelling, and re-running them. Open it from the rocket icon in the Studio nav rail.
The list is scoped to the active branch. To see deployments for a different branch, switch branches using the branch selector in the top bar.
What triggers a deployment
Section titled “What triggers a deployment”A workflow run is created when:
- A commit lands on a branch that is wired up for deployment — for example, after Studio commits a content change or after a pull request is merged.
- You click Deploy in the toolbar to dispatch a workflow run manually for the active branch.
- You click Re-run on an existing run.
Toolbar
Section titled “Toolbar”| Control | Description |
|---|---|
Deploy branch |
Triggers a workflow run for the active branch. |
| Refresh | Reloads the deployment list. |
| Live indicator | Appears (pulsing) while any run in the list is in a queued or in_progress state. While shown, the list auto-polls every 5 seconds. |
The Deploy button is hidden when Quant Builder is enabled — see Browser build and publish below.
Deployment list
Section titled “Deployment list”Each row shows:
| Field | Description |
|---|---|
| Status icon | Success, failed, in-progress, queued, cancelled, or skipped. |
| Title | The workflow run’s display title (typically the commit message). |
| Commit SHA | The short SHA of the commit being deployed. |
| Branch | The branch the run is deploying. |
| Time | A relative timestamp (e.g. “2 minutes ago”). |
| Duration | How long the run took (completed runs only). |
If the list is empty for a branch, the screen prompts you to push a commit or click Deploy to trigger a build.
Run detail
Section titled “Run detail”Click a row to expand its details. The expanded view shows:
- Cancel for in-progress and queued runs, or Re-run for runs that have completed.
- A list of jobs, each with their own status icon and duration.
- For each job, a list of steps (the individual stages from the workflow file).
- A log viewer that opens when you click a job header. The log is fetched live and stripped of ANSI escape codes.
Click the same row again to collapse it.
Browser build and publish
Section titled “Browser build and publish”When Quant Builder is enabled in Settings, the toolbar replaces the Deploy button with Build & Publish and adds a Force checkbox.
Clicking Build & Publish runs the Astro build in your browser and publishes the resulting pages directly to the Quant CDN, in parallel with syncing media files from your repository. A live progress card shows two bars while the run is in flight:
- Building / Publishing — page render and upload.
- Syncing media files — binary assets.
When the run finishes, the card shows a summary of pages published, unchanged, skipped, and failed, plus media-sync totals. Tick Force before clicking Build & Publish to clear the revision log first and republish every page, even unchanged ones.
Next steps
Section titled “Next steps”- Review and publishing — merge a pull request and watch the resulting deployment
- Settings — toggle Quant Builder on or off
- Branches and environments — switch branches to view their deployments
