How Jamdesk Works
Understanding the build and deployment pipeline
Jamdesk handles the entire documentation lifecycle from source to production.
The Pipeline
GitHub Repo → Jamdesk Build Service → CDN (Cloudflare R2) → Your Users
1. Source Control
Your documentation lives in a GitHub repository as MDX files alongside a docs.json configuration file.
2. Automatic Builds
When you push to your connected branch, Jamdesk:
- Pulls your latest content
- Validates your configuration
- Compiles MDX to optimized HTML
- Applies your theme and styling
3. Global CDN
Built sites are deployed to Cloudflare R2 with edge caching worldwide. Your users get fast load times regardless of location.
4. Custom Domains
Connect your own domain with automatic SSL certificates, or use the provided *.jamdesk.dev subdomain.
Build Triggers
Builds are triggered by:
- GitHub push to your connected branch
- Manual rebuild from the dashboard
- API call for CI/CD integration
Builds typically complete in 30-60 seconds for most documentation sites.