Beautiful documentation for Next.js and React.
An open-source framework for TypeScript, Tailwind CSS and Markdown. Routing, search, SEO and i18n are built in — you write files on disk.
---
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.
Next.js
React
TypeScript
Tailwind CSS
MDXWhy 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.
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 and no index to host.
SEO by default
Canonical links, sitemap, robots and generated Open Graph images, all from one config file.
Internationalisation
A folder per locale. Routes, sidebar, pager, search and interface strings all follow, with hreflang emitted for you.
Built for agents
An llms.txt, raw Markdown routes, an MCP server and agent skills, so tools
read your docs instead of scraping them.
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.
Drop an .mdx file into content/ and the route appears on its own.
Prose components are available by name. Nothing to import, nothing to register.
::note
Drop an `.mdx` file into `content/` and the route appears on its own.
::
::tip{to="/docs/essentials/components"}
Prose components are available by name. Nothing to import, nothing to register.
::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.
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.
Create a project
The CLI detects your package manager and can scaffold a single-language or i18n starter.
npx create-docora my-docsStart the dev server
cd my-docs && npm run devPreview the site at http://localhost:3000.
Add a page
Drop an .mdx file into content/ and the route and sidebar entry appear on
their own. Head to Project structure
when you want folders, prefixes and locales.
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.
Start writing
Everything is a file on disk. No database, no dashboard, no lock-in.