Your First Build
What happens after you connect a repo: build phases, the Deployments tab, and what to check if something fails.
Automatic Builds
Jamdesk starts your first build as soon as you connect a repository. Every later push to your connected branch triggers a new build.
Build Progress
Track your build in the dashboard:
Your build is waiting to start. Peak times can add a brief queue.
Jamdesk pulls your repository content from GitHub.
Jamdesk checks your docs.json and MDX files for errors.
Jamdesk compiles MDX to HTML with syntax highlighting and a search index.
Built files upload to the global CDN.
Your docs are available at your project URL.
Viewing Your Live Docs
Click View Site in the dashboard or visit https://your-project.jamdesk.app.
Your docs also appear on your custom domain, if you configured one.
Manual Rebuild
Rebuild without pushing changes:
- Go to your project in the dashboard
- Open Settings
- Click Rebuild
Use this after changing environment variables or to force a fresh build.
If Your Build Fails
The dashboard shows an error message for a failed build. Common causes:
- Invalid
docs.jsonsyntax - MDX syntax errors
- Missing pages referenced in navigation