---
title: Monitoring Builds
description: "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

<Steps>
  <Step title="Queued">
    Build is waiting to start. Most builds start within seconds.
  </Step>
  <Step title="Cloning">
    Pulling your repository content from GitHub.
  </Step>
  <Step title="Validating">
    Checking `docs.json` configuration and MDX syntax.
  </Step>
  <Step title="Processing">
    Parsing MDX files and resolving imports.
  </Step>
  <Step title="Building">
    Compiling MDX to HTML, applying syntax highlighting.
  </Step>
  <Step title="Deploying">
    Uploading to CDN and purging cache.
  </Step>
  <Step title="Live">
    Build complete. Your docs are updated.
  </Step>
</Steps>

## 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

## Build Logs

Detailed logs help debug issues:

```text
[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:

### Email

Enable build failure alerts in **Settings** → **Notifications**.

### Slack

Connect Slack to receive build notifications in your channel. See [Slack Integration](/integrations/slack).

## 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

<Columns cols={2}>
  <Card title="Triggering Builds" icon="play" href="/builds/triggering">
    Start builds manually or on push
  </Card>
  <Card title="Build Troubleshooting" icon="wrench" href="/builds/troubleshooting">
    Fix failed builds
  </Card>
</Columns>