Nextra
by Shu Ding / The Guild
Next.js-based framework for docs sites and blogs with a ready docs theme and a starter template repo.
Page and site templates Code libraryOpen sourceminimal
2. Commercial use: raw.githubusercontent.com
“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software”
MIT allows use for paid products and company sites; no visible credit is needed.
raw.githubusercontent.com3. Credit the author: raw.githubusercontent.com
“The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.”
No credit on screen. Keep the license notice inside the code you ship.
raw.githubusercontent.com4. Agent access: github.com/shuding/nextra
An agent can install it by itself with npm install nextra. No key or account is needed.
github.com/shuding/nextraLicense checked Nov 9, 2026 against 2 official pages. Tap a verdict to see its source. How we checked Report an error
Nextra: docs sites and blogs from Markdown
Nextra is a free tool that turns a folder of Markdown text files into a finished documentation site or blog. It adds the menu, sidebar, search, dark mode and table of contents for you. It runs on Next.js, so you or your AI assistant need a Next.js project to use it.
Where you can use it
Documentation for a product
Write help pages for your app, library or service as Markdown files and get a site with a sidebar, search and a table of contents on each page.
A blog for a project or company
Publish posts written in Markdown with the separate blog theme, which also has pages for tags and a feed.
Search across all pages
Readers can search every page of your docs right in the browser. The search index is made while the site is built, so no search server is needed.
Docs in several languages
Keep an English, German and Japanese copy of each page in folders per language; the site gets a language switch.
Docs on simple static hosting
Build the whole site as plain files and put it on GitHub Pages or any web server, without running a Node server.
Help center for a small app Idea
Turn your support answers into a searchable help site with step-by-step pages, tabs and notes, kept next to your app's code.
Nextra popularity
Downloads from api.npmjs.org, stars from GitHub, checked Nov 17, 2026. How the Gid Score is calculated
How to start
Tell your AI assistant
“Set up a Nextra 4.6.1 docs site with nextra-theme-docs on the Next.js App Router following nextra.site/docs/docs-theme/start, with pages in content/, Pagefind search as a postbuild step, and pinned versions instead of "latest".”
Or install it yourself. In a project folder, install Next.js, React, Nextra and the docs theme.
npm i next react react-dom nextra nextra-theme-docs
Show code
Add next.config.mjs with the nextra wrapper, an mdx-components file and app/layout.jsx as shown in the guide, then run the site.
npm run dev
Mistakes to avoid
The template asks for Next.js 13 and nextra "latest", which now installs Nextra 4, and that needs Next.js 14 or newer.
Nextra 4 dropped Pages Router support.
Search reads an index made from the built HTML, so it must run after the build.
The guide marks it as mandatory, otherwise the export fails.
The redirect proxy does not work with output 'export'.
License
MIT license. Free for personal and paid sites, no visible credit needed. If you pass on copies of the Nextra code, keep its copyright and license notice.
“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software” raw.githubusercontent.com
“The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.” raw.githubusercontent.com
“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software” raw.githubusercontent.com
“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software” raw.githubusercontent.com
AllowedWith conditionsNot allowedNot stated or not checked yet
Is Nextra free for commercial use? The full answer Not legal advice. Check the license page before you ship.
For your agent
License rules tell your agent what it may do with Nextra. Paste them into your prompt or AGENTS.md.
- Nextra (Page and site templates). Next.js-based framework for docs sites and blogs with a ready docs theme and a starter template repo. Price: free; commercial use OK; no credit needed. Style: minimal.
Connect: npm nextra.
Get files: npm i nextra nextra-theme-docs (Nextra 4.6.1 needs Next.js 14 or later, per its npm peer dependencies); setup guide at nextra.site. No account (mdx, tsx).
Not allowed: Needs Node.js
Rule: Keep the MIT copyright notice in the code if you redistribute it.
Rule: No visible credit on the site is required by the licence.
License: https://github.com/shuding/nextra/blob/main/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/nextra/)
Agent installs a package or loads it from a CDN.
npm install nextraFormats: mdx, tsx
Built with Nextra (MIT)Alternatives
Nextra This page
Pick Docusaurus for a React docs generator with a ready classic template that has docs, a blog and a landing page.
Pick Starlight when you prefer Astro; it gives navigation, search, translations and dark mode out of the box.
Pick Fumadocs for a Next.js or React Router docs framework with ready templates and pages made from API descriptions.
Official Bootstrap 5 example snippets and layouts: heroes, features, pricing, headers, footers, dashboards; one zip download.
Vite + Vue static site generator with a default docs theme and a home/landing layout.
Questions
Do I need to know Next.js?
A little. Nextra is a plugin for Next.js, so you need a Next.js project; the pages themselves are Markdown files.
Does search need a server or a paid service?
No. Pagefind builds the search index after the site is built, and the search runs in the reader's browser.
Can I host it as plain files, for example on GitHub Pages?
Yes, with a static export (output 'export' and unoptimized images in next.config.mjs).
Can I use it for a blog instead of docs?
Yes. Install nextra-theme-blog instead of nextra-theme-docs.
Is it free for a company site?
Yes. It is MIT licensed.