Jamdesk Documentation logo

Monitoring Builds

Track build progress in real time, understand each build phase, read structured build logs, and diagnose failures from the Jamdesk dashboard builds page.

Every build moves through several phases from queued to live. Monitor progress from the Deployments tab.

Build Phases

1
Queued

Build is waiting to start. Most builds start within seconds.

2
Cloning

Pulling your repository content from GitHub.

3
Validating

Checking docs.json configuration and MDX syntax.

4
Processing

Parsing MDX files and resolving imports.

5
Building

Compiling MDX to HTML, applying syntax highlighting.

6
Deploying

Uploading to CDN and purging cache.

7
Live

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, CLI)
  • Commit hash and message
  • Full build log

Warnings and Suggestions

Completed builds can carry two tiers of feedback:

  • Warnings (orange badge) — issues worth fixing, like broken links or missing assets. They never fail the build.
  • Suggestions (lightbulb) — optional polish for your site's branding and SEO, like adding a favicon, description, or logo. Suggestions appear only on your latest completed build, don't count toward the warning badge, and are never emailed.

Many broken-link and missing-description warnings can be repaired automatically. When your latest build has fixable issues, use Fix with AI to review and apply the changes without editing MDX by hand.

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

Jamdesk can alert you by email or Slack when a build finishes or fails:

Email

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:

  1. Go to the Deployments tab
  2. Find the running build
  3. Click Cancel

The previous successful build remains live.

Related Articles

Fix with AI

Auto-fix broken links and missing descriptions

Triggering Builds

Start builds manually or on push

Build Troubleshooting

Fix failed builds