Mintlify open source alternative

Holocron is the open source Mintlify alternative. It is a drop-in replacement: keep your docs.json, MDX pages, OpenAPI spec, and Mintlify components, then run them as a Vite plugin. Builds happen locally. You can self-host, or publish with the Holocron CLI.

Mintlify is a hosted docs platform. Beautiful defaults, Git sync, an AI assistant, and an API playground. It is also closed source, cloud-only, and Pro starts at $450 per month. Teams searching for a Mintlify open source alternative usually want the same authoring model without the lock-in.

bash

1npx -y "@holocron.so/cli" create

Ask AI about this page

Already on Mintlify? Keep the repo as-is. Add a Vite config and run it. See Migration from Mintlify.

Why this query exists

People type mintlify open source alternative when they want three things at once:

Mintlify-compatible authoring. docs.json, MDX, Cards, Callouts, Steps, OpenAPI tabs.
Open source. Readable code, no vendor roadmap risk, MIT license.
Self-hosting. Local vite build, standard CI, deploy on Node.js or Cloudflare Workers.

Most lists that rank for this query point at Docusaurus, Fumadocs, Scalar, or GitBook. Those are good tools. None of them render a Mintlify repo without a rewrite. Holocron does.

diagram

  your Mintlify repo                                      Holocron site
  ┌────────────────────────────────┐                      ┌────────────────────────────────┐
  │ docs.json                      │                      │ same docs.json                 │
  │ *.mdx  (Cards, Callouts, Steps)│── add plugin ───────>│ vite.config.ts                 │
  │ openapi.yaml                   │                      │ vite build / holocron deploy   │
  └────────────────────────────────┘                      └────────────────────────────────┘
         no content rewrite                                      local preview in seconds

What is Holocron

Vite plugin, local builds, Mintlify-compatible config and components.

Migrate from Mintlify

Four steps. Keep docs.json and MDX. Run npx vite.

Quickstart

Scaffold a site, write one MDX page, start the dev server.

Pricing

Generator is MIT and free. Optional Pro is $99 per site per month.

Drop-in Mintlify replacement

Holocron follows the Mintlify docs.json shape. Unknown Mintlify fields pass through validation, so you can paste a full Mintlify config without errors. Fields Holocron does not consume are ignored.

What transfers as-is:

Navigation. Tabs, groups, nested groups, anchors, versions, dropdowns, products.
MDX components. Accordions, Cards, Callouts, Steps, Tabs, Code Groups, Expandables, Frames, Fields, and more. See Components.
Frontmatter. title, description, icon, sidebarTitle, tag, hidden, deprecated.
Site chrome. Colors, logo, favicon, navbar, footer, redirects, appearance, fonts, banner, integrations.
OpenAPI tabs. { "tab": "API Reference", "openapi": "openapi.json" } generates one page per endpoint.

123456import { defineConfig } from 'vite'
import { holocron } from '@holocron.so/vite'

export default defineConfig({
  plugins: [holocron()],
})

Point that plugin at an existing Mintlify project. The same files that used to publish only through Mintlify cloud now preview on localhost with Vite HMR.

Holocron accepts docs.json, docs.jsonc, and holocron.jsonc. First found wins. Put "$schema": "https://holocron.so/docs.json" in the file for editor autocomplete.

Holocron vs Mintlify

Area	Mintlify	Holocron
License	Closed source SaaS	MIT, github.com/remorses/holocron
Hosting	Mintlify cloud only	Self-host, or holocron.so hosting
Build	Cloud build on git push	Local `vite build`, standard CI
Config	`docs.json`	Same `docs.json`
Components	Proprietary MDX set	Same names, open source implementations
Search	Hosted search	Orama, local, zero config
API reference	Interactive playground	Generated OpenAPI pages, request and response examples
AI assistant	Hosted assistant (Pro)	Built-in chat on the docs site, plus an embeddable widget
Docs maintenance	Writing agent and automations (Pro)	Holocron Maintain from page generation prompts
AI exports	`.md` routes, `llms.txt`, MCP, `skill.md`	`.md` routes, `/llms.txt`, `/docs.zip`, skill discovery
Custom app	Not a framework	Mount docs inside a Spiceflow app
Pricing	Free hobby, Pro $450/mo, Enterprise custom	Generator free. Optional Pro $99/mo per site

Holocron is not a pixel clone of every Mintlify dashboard product. It is the open source docs engine that understands Mintlify content.

Feature set

This is what the codebase ships today, mapped against the Mintlify feature surface people actually use.

Docs as code

Write MDX pages. Organize them with docs.json. Preview with Vite. Commit with Git. That is the same workflow Mintlify popularized, minus the hosted compiler.

Mintlify's web editor is a hosted CMS on top of Git. Holocron stays docs-as-code. Edit in the repo, in PRs, or with your own editor.

Navigation is the same tree: tabs, groups, pages. Holocron also implements:

Versions for API or product lines
Dropdowns and products, flattened into routes
Hidden pages that stay out of the sidebar
Imageboard for screenshot-heavy catalogs
pagesDir when MDX does not live at the repo root

Theming and layout

Override shadcn-style CSS variables and Holocron adapts. No proprietary theme JSON required.

Mintlify-compatible MDX components

In MDX, components are global. No imports. The names match Mintlify so existing pages keep compiling.

Callouts

Note, Warning, Info, Tip, Check, Danger.

Cards

Card and CardGroup grids.

Steps

Numbered procedures.

Tabs

Switchable content panes.

Accordions

Collapsible sections.

API fields

Param, ResponseField, Expandable.

Also: Code groups, Frames, Mermaid, Tree, Update, Prompt, Visibility, Panel, Tiles. Full index: Components.

OpenAPI reference

Point a tab at an OpenAPI file. Holocron generates one MDX page per endpoint, with parameters, examples, and SDK snippets.

Mintlify's interactive API playground (live "Try it" against a server) is a hosted product. Holocron renders a read-only reference from the spec. For most public API docs that is the page users read.

Changelog and MCP docs

Mintlify can turn GitHub releases and MCP servers into docs surfaces. So can Holocron:

Changelog tab from a GitHub repo URL, one <Update> per release
MCP docs from a local JSON file or a remote MCP server
MCP export so agents can install your docs as tools

AI-readable docs

Mintlify markets agent-native docs: Markdown for crawlers, llms.txt, MCP, skill.md. Holocron ships the same idea, then adds bulk download.

Endpoint	What agents get
`page.md`	Raw Markdown for any page. See Markdown routes.
`/llms.txt`	Index of titles and `.md` URLs. See llms.txt.
`/docs.zip`	Every page as `.md` in one archive. See docs.zip.
`/.well-known/agent-skills/`	Installable skill for coding agents. See Skill discovery.

/docs.zip is the fastest way for an agent to grep a whole site. Mintlify does not ship this archive.

Enable AI Assistant in docs.json. Readers ask questions against your docs. Display it in the sidebar or as a floating pill.

The same chat can be embedded on any website, not only the docs origin.

Free hosted sites get a trial model. Holocron Pro ($99 per site per month) unlocks the full model and 50,000 credits. Compare that with Mintlify Pro at $450 per month plus credit overages.

Holocron Maintain

Mintlify Pro includes a writing agent and scheduled automations. Holocron's counterpart is Maintain.

Every page can store a generation prompt in frontmatter. When referenced source files change, Maintain reruns that prompt and updates the MDX. Run it from a parent agent, or from GitHub Actions so a pull request opens on push.

Deploy anywhere

Mintlify publishes only to Mintlify cloud. A Mintlify open source alternative has to leave with you.

diagram

                              vite build
                                  │
                                  v
                 ┌────────────────┼────────────────┐
                 v                v                v
            Node server      Cloudflare       holocron deploy
            dist/rsc         Workers          managed hosting

Node.js: npx vite build && node dist/rsc/index.js
Cloudflare Workers: npx wrangler deploy
Holocron hosting: npx -y "@holocron.so/cli" deploy
Subpath hosting: docs at yoursite.com/docs
Multi-tenant: one worker, many sites

Custom domains and unlimited preview deployments are Holocron Pro. The open source generator itself has no seat limit and no cloud requirement.

Custom routes, not a walled garden

Mintlify is a docs host. Holocron is a Vite plugin on Spiceflow. Custom entry mounts docs next to your own API routes, auth, and pages. That is how holocron.so itself is built.

What Holocron does not copy

Honesty ranks better than a fake parity table.

Interactive API playground. Holocron generates reference pages. It does not proxy live authenticated requests from the browser.
Hosted web editor. Edit Markdown in Git. There is no Mintlify-style browser CMS.
Mintlify analytics dashboard. Use the integrations field (GA4, PostHog, Plausible, and similar). A native Holocron analytics view is not shipping yet.
SSO, SCIM, RBAC, PDF export. Those are Mintlify Enterprise products. Self-host Holocron behind your own auth if you need a private site.
Mintlify Index (cross-publisher search API) and static export as a paid REST job. Holocron sites already emit Markdown and a zip; you own the build output.

If those hosted extras are the product you want, stay on Mintlify. If you want your Mintlify files, locally, as open source, Holocron is the drop-in.

Holocron vs other Mintlify alternatives

Search results for this query mix SaaS clones and generic static generators. The split is simple.

Tool	Open source?	Renders a Mintlify repo as-is?
Holocron	Yes, MIT	Yes. Same `docs.json` and MDX components.
Docusaurus	Yes	No. Different config, different components, rewrite required.
Fumadocs	Yes	No. Next.js framework with its own MDX map.
Scalar	Yes	No. API-reference first, not a Mintlify docs.json runtime.
GitBook	No	No. Different editor and Git sync model.
Unmint and similar themes	Partial	Visual mimic, not a drop-in compiler for existing Mintlify pages.

The ranking intent behind mintlify open source alternative is not "any docs tool that is free." It is "Mintlify, without the closed cloud." Holocron is built for that intent.

Migrate in four steps

From Migration from Mintlify:

pnpm add @holocron.so/vite react react-dom vite
Add the holocron() plugin in vite.config.ts
Keep docs.json and every .mdx file
npx vite

Open http://localhost:5173. If pages live in a subfolder, set holocron({ pagesDir: './pages' }).

FAQ

Is there an open source Mintlify alternative?

Yes. Holocron. It is MIT licensed, runs as a Vite plugin, and reads Mintlify docs.json plus MDX. Source: github.com/remorses/holocron.

Can I self-host Mintlify?

Not the Mintlify platform. Mintlify is cloud-only on paid plans; even Enterprise self-hosting is a sales conversation. Holocron self-hosts on Node.js or Cloudflare Workers with a normal vite build.

Does Holocron support Mintlify components?

Yes, for the components it documents: Accordions, Cards, Callouts, Steps, Tabs, Code Groups, Expandables, Fields, Frames, and the rest of the component catalog. Prop interfaces stay Mintlify-compatible. Holocron-only extras are additive.

How much does a Mintlify open source alternative cost?

The Holocron generator is free. Optional Holocron Pro is $99 per site per month ($990 per year) for the full AI model, Maintain, custom domains, and unlimited preview deployments. Mintlify Pro is $450 per month.

Is Docusaurus a Mintlify alternative?

Docusaurus is an open source docs generator. It is not drop-in. You rewrite navigation, components, and often the page layout. Use Docusaurus if you already live in that ecosystem. Use Holocron if you already have Mintlify files.

Get started

Install Holocron

Create vite.config.ts, add docs.json, write index.mdx.

Switch from Mintlify

Keep the repo. Add the plugin. Preview locally.