An Open Source Documentation Framework for React and Next.js

Built with TypeScript, Tailwind CSS and MDX — with routing, search, SEO, i18n and an MCP server built in, so both people and AI tools can read your docs.

Get started Browse components

getting-started.mdxpreviewlive

---
title: Getting started
description: Scaffold a site and start writing.
---
 
::note
Every file under `content/` is a route.
::
 
Write Markdown, drop in callouts, and the
sidebar picks the page up on its own.

Getting started

Scaffold a site and start writing.

Every file under content/ is a route.

Write Markdown, drop in callouts, and the sidebar picks the page up on its own.

content/docs/getting-started.mdx

Why Docora

Everything a documentation site needs

A Next.js theme, not a CMS. You keep the App Router, the content folder, and a single config file.

File-based routing

Every file under content/ becomes a route. Numeric prefixes set sidebar order and never appear in the URL.

content/
index.mdx
docs/
1.getting-started/
1.introduction.mdx
2.installation.mdx

1. orders the sidebar and never reaches the URL.

Built for agents

An llms.txt, raw Markdown routes, an MCP server and agent skills, so tools read your docs instead of scraping them.

/llms.txt/llms-full.txt/mcp/raw/*.md/.well-known/skills

Markdown with components

MDC syntax puts callouts, cards, tabs and steps in your Markdown with no imports. JSX still works when you need it.

Instant search

A command palette over every page, built at compile time. No service to run, no index to host.

Search the docs…CtrlK

Installation

Code blocks

SEO by default

Canonical links, sitemap, robots and generated Open Graph images, all from one config file.

sitemap.xmlrobots.txtcanonicalhreflangog:image

DocoraGenerated Open Graph imagedocora.dev

Internationalisation

A folder per locale. Routes, sidebar, pager, search and interface strings all follow, with hreflang emitted for you.

enEnglishcontent/en/

frFrancaiscontent/fr/

deDeutschcontent/de/

Built for agents

Your docs, queryable by anything that reads MCP.

MCP server, zero config
list-pages and get-page tools, live at /mcp.
llms.txt out of the box
A clean, agent-readable summary of your whole site.
Ask AI, opt-in
A chat widget that answers from your docs and cites sources.

Read the AI & agents guide

cursor — mcp: docoraconnected

How do I highlight specific lines in a code block?

get-page·/docs/essentials/code-blocks

Add a line range to the fence meta — Docora passes it straight to Shiki:

```ts [config.ts] {2,5-7}

Source:/raw/docs/essentials/code-blocks.md

/mcp

Zero-config MCP server

llms.txt

Agent-readable index

Authoring

Write Markdown, get a component

MDC keeps the source readable. The page stays rich — callouts, cards, tabs, steps, and code that does more than highlight.

introduction.mdxpreviewlive

::note
Drop an `.mdx` file into `content/`
and the route appears on its own.
::
 
::tip
Prose components are available by name.
Nothing to import.
::
 
::warning
Be careful with this action as it might
have unexpected results.
::
 
::caution
This action cannot be undone.
::

Preview

Drop an .mdx file into content/ and the route appears on its own.

Prose components are available by name. Nothing to import.

Be careful with this action as it might have unexpected results.

This action cannot be undone.

Project shape

A Next.js app, a content folder

Scaffolding gives you an App Router project. Add pages as files; keep using anything else Next.js already does.

Your project

import { defineDocsConfig } from 'docora'
 
export default defineDocsConfig({
  site: {
    name: 'Acme',
    description: 'Acme documentation',
  },
})

Get going

Up and running in one command

Scaffold a site, start the dev server, and start writing. Node.js 20.9 or later is required.

Step01
Create a project
The CLI detects your package manager and can scaffold a single-language or i18n starter. See the installation guide and project structure.
Terminal
npx create-docora my-docs
Step02
Start the dev server
Preview the site at localhost:3000 with hot reload on every file you touch.
Terminal
cd my-docs npm run dev ▲ Next.js - Local: http://localhost:3000
Step03
Add a page
Drop an .mdx file into content/ and the route and sidebar entry appear on their own.
getting-started.mdxpreview
--- title: Getting started --- Every file under `content/` is a route.

Already have a Next.js app?Wire the theme into it instead

Trade-offs

What Docora optimizes for

Not every docs tool should make the same choices. These are ours, stated plainly, so you can tell in a minute whether they match your project.

Docora

Open source, MIT

Setup: One command, files on disk
Content: Markdown / MDX, no CMS required
AI access: MCP server + llms.txt built in
Hosting: Any Next.js host, including self-hosted
Styling: Tailwind and CSS variables — no fork to reskin

Guides

Where to go next

Pick a path. Each guide is a file in the repo, the same way your docs will be.

Installation

Scaffold a site, or wire the theme into an existing Next.js app.

Configuration

Site name, header links, navigation, search and footer — one typed object.

Theme

CSS variables, colour mode and typography — reskin without forking the package.

Customization

Header slots, extra MDX components, or a layout you assemble yourself.

AI and agents

llms.txt, an MCP server and skills so tools can read the corpus.

FAQ

Questions, answered

Short answers for the things people usually ask before they scaffold.

Do I need a CMS?

No. Pages are Markdown files and Git is the workflow. You can still add ordinary App Router routes next to the catch-all when a page needs custom React.

Can I add this to an existing Next.js app?

Yes. Docora is a theme package. Install docora, wrap your Next config with withDocora, and point it at a content/ folder. See Installation.

How does search work?

The index is built when the site compiles. There is no hosted search service and nothing extra to deploy — open it from the header or with Ctrl K.

Can language models read the docs?

Yes. Every site exposes /llms.txt, full-corpus /llms-full.txt, raw Markdown at /raw/{path}.md, and an MCP server at /mcp.

Does the AI chat feature cost anything to run?

Answers go through the Vercel AI Gateway — bring your own API key or use the free tier. The widget is opt-in, so a site that never enables it makes no model calls at all.

Is Docora related to Docus?

Docora is inspired by Docus (Nuxt) but is an independent project built for Next.js and React, with its own architecture and AI-native features like a built-in MCP server.

Start writing

Everything is a file on disk. No database, no dashboard, no lock-in.

Read the docs View on GitHub

MIT licensed
No database
No dashboard
No lock-in