Build documentation that feels like part of your Next.js application.
NextGuide is an all-in-one documentation framework for Next.js. Write MDX guides, publish API references, and build accessible, responsive documentation with reusable components—all in one nextguide package.
Documentation · Components · npm · Report an issue
Start with an existing Next.js application, or create one:
bunx create-next-app@latest my-docs
cd my-docs
bun add nextguide@alpha
bunx nextguide init --developer
bun run devVisit /docs on the address printed by Next.js. NextGuide generates documentation pages, navigation metadata, a component registry, and the required styles and routes. You can inspect the changes beforehand with bunx nextguide init --developer --dry-run.
Release status: NextGuide is currently published on the npm
alphachannel. The published version may lag behind development; Account Mode and recent navigation fixes are not yet part of a verified stable release. See the installation guide for the supported workflow.
- Ready-to-use documentation: responsive sidebar, search, table of contents, breadcrumbs, page tools, and light/dark appearance.
- MDX authoring: editable files inside your project, with callouts, code examples, tabs, file trees, cards, and more.
- API references: OpenAPI support from the same package.
- Your stack, your hosting: Next.js App Router or Pages Router, TypeScript or JavaScript; static deployment options for Developer Mode.
- Safe changes: CLI commands generate files in the appropriate directories and preserve existing user-authored content.
| Developer Mode | Account Mode |
|---|---|
| Edit MDX and configuration files using your editor and Git. | Manage content and site settings through a browser dashboard. |
| Works with static exports and standard Next.js deployments. | Requires a persistent Next.js server and private storage. |
| Available in the published alpha (features vary by alpha version). | In development; not yet published to npm. |
Learn more: Developer Mode · Account Mode preview.
bunx nextguide page add guides/installation --title "Installation"The CLI creates the MDX file and updates the sidebar metadata. Learn about page creation.
import { CodeWindow, CodeTabs, Callout, FileTree } from "nextguide/blocks"
import { Button, Dialog, Tabs } from "nextguide/ui"
import { createDocs } from "nextguide/mdx"
import "nextguide/styles.css"Explore the component catalog for demos and usage examples.
Don't reinitialize an existing project. Use bunx nextguide upgrade --dry-run to preview configuration changes. To adopt updated generated layouts, use bunx nextguide upgrade --refresh-generated --dry-run and review the backups before applying. Your MDX pages and _meta.json navigation are preserved. See upgrading safely.
Bug reports, documentation improvements, and code contributions are welcome. See CONTRIBUTING.md for source builds, local package testing, and development commands. For 1.0.0 progress, follow the release checklist.
MIT. See LICENSE and THIRD_PARTY_NOTICES.md for third-party attribution.