Monitoring Builds
Track build progress, understand phases, and read build logs from the dashboard.
Every build moves through several phases from queued to live. Monitor progress from the Deployments tab.
Build Phases
Build is waiting to start. Most builds start within seconds.
Pulling your repository content from GitHub.
Checking docs.json configuration and MDX syntax.
Parsing MDX files and resolving imports.
Compiling MDX to HTML, applying syntax highlighting.
Uploading to CDN and purging cache.
Build complete. Your docs are updated.
Viewing Build Status
Dashboard Overview
Your project's main page shows:
- Current build status
- Last successful deploy time
- Recent build history
Build Details
Click any build to see:
- Start and end time
- Duration
- Triggered by (push, manual, API)
- Commit hash and message
- Full build log
Build Logs
Detailed logs help debug issues:
[12:34:56] Starting build...
[12:34:57] Cloning repository...
[12:34:59] Found docs.json at root
[12:35:00] Validating configuration...
[12:35:01] Processing 45 pages...
[12:35:15] Building search index...
[12:35:18] Deploying to CDN...
[12:35:22] Build complete!Build Notifications
Get notified about build status:
Enable build failure alerts in Settings → Notifications.
Slack
Connect Slack to receive build notifications in your channel. See Slack Integration.
Build History
View your last 30 builds in the Deployments tab:
- Build status (success, failed, cancelled)
- Duration
- Trigger type
- Commit information
Cancelling Builds
To cancel a running build:
- Go to the Deployments tab
- Find the running build
- Click Cancel
The previous successful build remains live.