Ardo
Documentation for React teams
Your components. Your stack. Your docs. Build documentation with React 19, React Router 7, and MDX. Drop in your existing components and generate API references straight from TypeScript.
From zero to docs in four lines
Scaffold a complete documentation site. Add an MDX file, see it in the sidebar.
$ pnpm create ardo@latest my-docs
$ cd my-docs && pnpm install
$ pnpm dev
✓ Server running at http://localhost:5173What's in the box
Everything a documentation site needs, nothing it doesn't
React 19, natively
Not a React compatibility layer on top of something else. Actual React 19 with Server Components, Suspense, and the patterns you already use in your app.
Vite 8 with Rolldown
Dev server starts in under a second. HMR updates hit the browser before you look up from your editor. Production builds are just as fast.
TypeDoc, zero config
Point Ardo at your TypeScript source and it generates linked API reference pages. Interfaces, types, functions, classes. No plugins to install.
Type-safe routes
React Router 7 gives you typed navigation. Link to a page that doesn't exist? TypeScript tells you at build time, not your users at runtime.
Light and dark mode
Both themes ship by default. Follows system preferences, togglable by the reader, smooth transitions. Covers code blocks too.
Offline-capable search
Full-text search powered by MiniSearch. Runs entirely in the browser. No external service to configure, no API keys, works offline.
MDX with Shiki
Write Markdown, import React components where you need them. Code blocks are syntax-highlighted at build time with Shiki. No client-side JS for highlighting.
Make it yours
CSS custom properties for theming. Override any component. Bring your own layout if the defaults don't fit. It's your site.
Markdown when it's enough, React when it's not
Plain Markdown for content. Drop in a React component when you need something interactive.
---
title: Getting Started
---
# Getting Started
Install Ardo with your favorite package manager:
```bash
pnpm add ardo react react-dom
```
:::tip
Use `create-ardo` for a complete project setup!
:::
<CustomAlert type="info">
You can use **any React component** in your docs.
</CustomAlert>Your stack, not ours
Ardo is built on the tools React teams already use. Nothing new to learn.
How Ardo compares
Great tools exist. The question is whether they fit your stack.
| Ardo | Docusaurus | Starlight | VitePress | |
|---|---|---|---|---|
| UI framework | React 19 | React | Astro | Vue |
| Build tool | Vite 8 | Webpack | Astro/Vite | Vite |
| Your React components | Native | Native | Via islands | No |
| TypeDoc built in | Yes | Plugin | Plugin | No |
| First load | ~111 KB | ~500 KB+ | ~50 KB | ~50 KB |
| CO₂ per visit | ~0.04g (A) | ~0.10g (B) | ~0.01g (A+) | ~0.04g (A) |
Ship your docs this week
Four lines in your terminal. A complete documentation site. What are you waiting for?