Your First Build
What happens after you connect a repo -- build phases, the Deployments tab, and what to check if something fails.
Your first build starts automatically when you connect a repository.
Automatic Builds
When you connect a repository, Jamdesk triggers an initial build immediately. Every subsequent push to your connected branch triggers a new build automatically.
Build Progress
Track your build in the dashboard:
Your build is waiting to start. During peak times, there may be a brief queue.
Jamdesk pulls your repository content from GitHub.
Your docs.json and MDX files are validated for errors.
MDX is compiled to optimized HTML with syntax highlighting and search indexing.
Built files upload to the global CDN.
Your docs are available at your project URL.
Viewing Your Live Docs
Once the build completes, click View Site in the dashboard or visit:
https://your-project.jamdesk.app
If you configured a custom domain, your docs will also be available there.
Manual Rebuild
Need to 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
Build failures show an error message in the dashboard. Common causes:
- Invalid
docs.jsonsyntax - MDX syntax errors
- Missing pages referenced in navigation