Introduction
HolyDocs is an AI-native documentation platform built on Cloudflare, designed to replace Mintlify with a faster, smarter, and more extensible developer docs experience.
What is HolyDocs?
HolyDocs is a modern documentation platform purpose-built for developer teams. It combines the authoring simplicity of MDX with AI-powered features like semantic search, an embedded chat assistant, and an autonomous documentation agent — all running on Cloudflare's edge network for sub-50ms page loads worldwide.
HolyDocs is fully compatible with existing Mintlify documentation projects. You can migrate in under five minutes using the holydocs migrate CLI command.
Key Features
How It Works
Write your docs
Author documentation in MDX files with YAML frontmatter. Use built-in components for rich content like callouts, tabbed code blocks, and interactive API references.
Configure with docs.json
Define your navigation structure, theme, colors, and features in a single docs.json configuration file at the root of your docs directory.
Push to deploy
Connect a GitHub or GitLab repository. Every push to your default branch triggers a build and deploys to Cloudflare's edge network. Pull requests get preview deployments automatically.
AI indexes your content
After each deployment, HolyDocs automatically chunks and embeds your content into a Vectorize index. This powers semantic search, the AI chat assistant, and the MCP server.
Compared to Alternatives
| Feature | HolyDocs | Mintlify | GitBook | ReadMe |
|---|---|---|---|---|
| Edge rendering | Cloudflare Workers | Vercel | Custom | Custom |
| AI chat assistant | Built-in RAG | Add-on | Basic | No |
| MCP server | Per-project | No | No | No |
| OpenAPI playground | Interactive | Interactive | Basic | Interactive |
| Git integration | GitHub + GitLab | GitHub | GitHub | No |
| SSO/SAML | Business plan | Enterprise | Enterprise | Enterprise |
| AI translation | 24 languages | No | No | No |
| Autonomous agent | Built-in | No | No | No |
| Pricing | Free tier available | $150/mo+ | Free tier | $99/mo+ |
| Custom domains | All plans | Paid only | Paid only | Paid only |
| Preview deployments | Pro+ | All plans | All plans | No |
| Content versioning | Built-in | Limited | Built-in | No |
| Webhooks | Pro+ | Enterprise | Enterprise | Enterprise |
| Changelog | Built-in | No | No | No |
| Feedback collection | Built-in | No | No | Built-in |
| MDX components | 15+ built-in | 15+ built-in | Limited | No |
| API code samples | 7 languages, auto | 6 languages | Manual | Manual |
Architecture
HolyDocs runs entirely on Cloudflare infrastructure with zero external dependencies:
- Workers — API server and rendering engine at the edge (200+ global locations)
- D1 — SQLite database for projects, deployments, and metadata
- R2 — Object storage for assets, built pages, and OpenAPI specs
- KV — Key-value cache for rendered pages and search indices
- Vectorize — Vector database for AI-powered semantic search
- Queues — Async job processing for builds, AI indexing, translation, and agent tasks
- Pages — Dashboard hosting with instant deploys
This architecture means there is no single origin server. Every request is handled at the nearest Cloudflare edge location, resulting in consistent sub-50ms response times regardless of where your readers are located.
Because HolyDocs runs on Cloudflare's edge network, your documentation benefits from automatic DDoS protection, global CDN caching, and 99.99% uptime SLA — all without any additional configuration.
Why HolyDocs?
Documentation is the first touchpoint developers have with your product. A slow, hard-to-search, or outdated docs site costs you adoption. HolyDocs was built to solve the problems we kept running into with existing platforms:
Every page is rendered and served from Cloudflare's edge network. There is no origin server to hit, no cold start to wait for. Your readers get instant page loads whether they are in San Francisco, Sao Paulo, or Singapore.
The built-in AI assistant uses retrieval-augmented generation with your actual documentation content — not a generic LLM with no context. Readers get accurate, sourced answers instead of hallucinated guesses.
Push to your Git repository and your docs are live in seconds. Preview deployments on every pull request. No build scripts to maintain, no CI pipelines to configure, no infrastructure to manage.
Already using Mintlify? Run holydocs migrate and your existing docs, navigation, components, and configuration transfer automatically. Most projects migrate in under five minutes.
Search, analytics, AI assistant, translation, changelog, feedback, API playground, versioning — all built in. No stitching together third-party services or managing separate billing for each capability.
Who Is HolyDocs For?
HolyDocs serves a broad spectrum of users, from individual developers to large enterprise teams. Here is how different users benefit:
HolyDocs scales from a single-page README to thousands of pages across multiple products and languages. You never need to re-platform as your documentation grows.
Compared to Alternatives (Detailed)
Beyond the feature matrix above, here is how HolyDocs differs in practice:
| Capability | HolyDocs | Others |
|---|---|---|
| Time to first deploy | Under 2 minutes from holydocs init to live site | Typically 10-30 minutes with config, CI setup |
| Search quality | Hybrid keyword + semantic vector search | Usually keyword-only or basic fuzzy match |
| AI assistant accuracy | RAG with source citations from your actual docs | Generic chatbot or unavailable |
| Build speed | Incremental builds, typically under 10 seconds | Full rebuilds on every push, 30-120 seconds |
| Preview deployments | Automatic on every PR with unique URL | Often requires separate CI configuration |
| Content freshness | AI agent detects stale content automatically | Manual review or nothing |
| Internationalization | AI translation to 24 languages with glossary | Manual translation or external service |
| Analytics | Built-in privacy-friendly analytics, no third-party scripts needed | Requires separate analytics integration |
| Customization | 11 themes, custom fonts, colors, and component styling | Limited theme options, often requires CSS overrides |
| MCP server | Per-project MCP server for IDE integration | Not available |
Plans and Pricing
HolyDocs offers plans for every stage of growth:
| Free | Starter | Pro | Business | Enterprise | |
|---|---|---|---|---|---|
| Projects | 1 | 3 | Unlimited | Unlimited | Unlimited |
| Pages | 50 | 200 | 500 | Unlimited | Unlimited |
| Builds/day | 10 | 30 | 100 | 500 | Unlimited |
| AI assistant | -- | -- | 250 msg/mo | 500 msg/mo | Unlimited |
| Custom domains | 0 | 1 | 5 | 20 | Unlimited |
| SSO/SAML | -- | -- | -- | Yes | Yes |
| AI translation | -- | -- | -- | Yes | Yes |
Getting Help
For the fastest response, search the docs first — the AI assistant (Cmd+I) can usually answer your question instantly using the documentation content.