Skip to content
Agents tracked: 502 Releases (7d): 613 Agent status: 4 with issuesSince last limit reset: Claude 7d · Codex 5d For AI agents: Markdown Updated Nov 18, 2026

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

GitHub repoWebsite

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.com

License 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

49 / 100
Gid Score, same scale as developer tools
13,958
GitHub stars
294.6K
npm downloads, last 7 days
+17.4% in 4 weeks
Nextra: downloads per weeknpm, nextra 294,642
Nextra: GitHub starsshuding/nextra 13,958

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

Cloning shuding/nextra-docs-template and running pnpm i
Follow the Docs Theme guide on nextra.site (or copy examples/docs from the nextra repository) and pin nextra and nextra-theme-docs to 4.6.1

The template asks for Next.js 13 and nextra "latest", which now installs Nextra 4, and that needs Next.js 14 or newer.

Adding Nextra 4 to a site built with the pages/ folder (Pages Router), or following Nextra 2 or 3 guides with theme.config.jsx
Use the App Router with app/layout.jsx and a content folder, or stay on Nextra 3 for the Pages Router

Nextra 4 dropped Pages Router support.

Expecting search to work after next build alone
Install pagefind and add the postbuild script that indexes .next/server/app (output to public/_pagefind, or out/_pagefind for a static export)

Search reads an index made from the built HTML, so it must run after the build.

output: 'export' without images: { unoptimized: true }
Set images.unoptimized to true in next.config.mjs for a static export

The guide marks it as mandatory, otherwise the export fails.

Relying on automatic language redirects on a statically exported multilingual site
Use a server build for the redirect, or link the language versions by hand

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.

Commercial use
Yes

“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

Credit
Not needed

“The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.” raw.githubusercontent.com

Inside your app or game
Can ship inside your app

“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

Pass the files on to your users
Allowed

“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

AI training
Not stated
Bots and bulk downloads
Not stated

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.

License rules
- 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/)
Can an agent use it by itself?
Yes.

Agent installs a package or loads it from a CDN.

Install
npm install nextra
How an agent gets 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.

Formats: mdx, tsx

Repository
API, key or account
Not needed. Everything runs on your side.
MCP server
None found
Credit line, if you want one
Built with Nextra (MIT)
This card for machines

Alternatives

Nextra This page

Free Commercial OK npm

Docusaurus

Pick Docusaurus for a React docs generator with a ready classic template that has docs, a blog and a landing page.

Free Commercial OK npm

Starlight

Pick Starlight when you prefer Astro; it gives navigation, search, translations and dark mode out of the box.

Free Commercial OK npm

Fumadocs

Pick Fumadocs for a Next.js or React Router docs framework with ready templates and pages made from API descriptions.

Free Commercial OK npm

Bootstrap Examples

Official Bootstrap 5 example snippets and layouts: heroes, features, pricing, headers, footers, dashboards; one zip download.

Free Commercial OK npm

VitePress

Vite + Vue static site generator with a default docs theme and a home/landing layout.

Free Commercial OK npm

All page and site templates

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.