{
 "slug": "nextra",
 "name": "Nextra",
 "author": "Shu Ding / The Guild",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Next.js-based framework for docs sites and blogs with a ready docs theme and a starter template repo.",
 "category": {
  "slug": "page-templates",
  "name": "Page and site templates"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "minimal"
 ],
 "logo_url": "https://agentgid.com/media/avatars/shuding.png",
 "logo_letter": "N",
 "links": {
  "repo": "https://github.com/shuding/nextra",
  "website": "https://nextra.site",
  "api_docs": null
 },
 "preview": null,
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "nextra.site",
    "url": "https://nextra.site"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "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",
   "note": "MIT allows use for paid products and company sites; no visible credit is needed.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/shuding/nextra/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/shuding/nextra/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install nextra. No key or account is needed.",
   "source": {
    "label": "github.com/shuding/nextra",
    "url": "https://github.com/shuding/nextra"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://github.com/shuding/nextra/blob/main/LICENSE",
  "summary": "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.",
  "pages_read": 2,
  "rules": [
   "Keep the MIT copyright notice in the code if you redistribute it.",
   "No visible credit on the site is required by the licence."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "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",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/shuding/nextra/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/shuding/nextra/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "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",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/shuding/nextra/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "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",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/shuding/nextra/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-09",
  "commercial_use_page": "https://agentgid.com/assets/nextra/commercial-use/"
 },
 "overview": {
  "heading": "Nextra: docs sites and blogs from Markdown",
  "body": "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."
 },
 "uses": [
  {
   "title": "Documentation for a product",
   "text": "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.",
   "idea": false,
   "image": null
  },
  {
   "title": "A blog for a project or company",
   "text": "Publish posts written in Markdown with the separate blog theme, which also has pages for tags and a feed.",
   "idea": false,
   "image": null
  },
  {
   "title": "Search across all pages",
   "text": "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.",
   "idea": false,
   "image": null
  },
  {
   "title": "Docs in several languages",
   "text": "Keep an English, German and Japanese copy of each page in folders per language; the site gets a language switch.",
   "idea": false,
   "image": null
  },
  {
   "title": "Docs on simple static hosting",
   "text": "Build the whole site as plain files and put it on GitHub Pages or any web server, without running a Node server.",
   "idea": false,
   "image": null
  },
  {
   "title": "Help center for a small app",
   "text": "Turn your support answers into a searchable help site with step-by-step pages, tabs and notes, kept next to your app's code.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "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\".",
  "install": "npm i next react react-dom nextra nextra-theme-docs",
  "install_note": "In a project folder, install Next.js, React, Nextra and the docs theme.",
  "code": [
   {
    "tab": "Step 1",
    "intro": "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.",
    "source": "npm run dev"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "Cloning shuding/nextra-docs-template and running pnpm i",
   "fix": "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",
   "why": "The template asks for Next.js 13 and nextra \"latest\", which now installs Nextra 4, and that needs Next.js 14 or newer.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Adding Nextra 4 to a site built with the pages/ folder (Pages Router), or following Nextra 2 or 3 guides with theme.config.jsx",
   "fix": "Use the App Router with app/layout.jsx and a content folder, or stay on Nextra 3 for the Pages Router",
   "why": "Nextra 4 dropped Pages Router support.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Expecting search to work after next build alone",
   "fix": "Install pagefind and add the postbuild script that indexes .next/server/app (output to public/_pagefind, or out/_pagefind for a static export)",
   "why": "Search reads an index made from the built HTML, so it must run after the build.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "output: 'export' without images: { unoptimized: true }",
   "fix": "Set images.unoptimized to true in next.config.mjs for a static export",
   "why": "The guide marks it as mandatory, otherwise the export fails.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Relying on automatic language redirects on a statically exported multilingual site",
   "fix": "Use a server build for the redirect, or link the language versions by hand",
   "why": "The redirect proxy does not work with output 'export'.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install nextra",
  "repo": "https://github.com/shuding/nextra",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "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.",
  "formats": [
   "mdx",
   "tsx"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Built with Nextra (MIT)",
  "rules_text": "- 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.\n  Connect: npm nextra.\n  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).\n  Not allowed: Needs Node.js\n  Rule: Keep the MIT copyright notice in the code if you redistribute it.\n  Rule: No visible credit on the site is required by the licence.\n  License: https://github.com/shuding/nextra/blob/main/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/nextra/)",
  "agent_md": "https://agentgid.com/assets/nextra/agent.md",
  "card_json": "https://agentgid.com/assets/nextra/card.json"
 },
 "popularity": {
  "gid_score": 49,
  "stars": 13958,
  "downloads_7d": 294642,
  "downloads_7d_label": "294.6K",
  "downloads_change_4w_pct": 17.4,
  "eco": "npm",
  "package": "nextra",
  "repo": "shuding/nextra",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     117021
    ],
    [
     "2025-11-24",
     114781
    ],
    [
     "2025-12-01",
     132889
    ],
    [
     "2025-12-08",
     131188
    ],
    [
     "2025-12-15",
     117451
    ],
    [
     "2025-12-22",
     59472
    ],
    [
     "2025-12-29",
     56451
    ],
    [
     "2026-01-05",
     107729
    ],
    [
     "2026-01-12",
     119118
    ],
    [
     "2026-01-19",
     127385
    ],
    [
     "2026-01-26",
     137878
    ],
    [
     "2026-02-02",
     139867
    ],
    [
     "2026-02-09",
     133411
    ],
    [
     "2026-02-16",
     123047
    ],
    [
     "2026-02-23",
     130368
    ],
    [
     "2026-03-02",
     145016
    ],
    [
     "2026-03-09",
     144612
    ],
    [
     "2026-03-16",
     137765
    ],
    [
     "2026-03-23",
     134057
    ],
    [
     "2026-03-30",
     150426
    ],
    [
     "2026-04-06",
     146771
    ],
    [
     "2026-04-13",
     145554
    ],
    [
     "2026-04-20",
     154390
    ],
    [
     "2026-04-27",
     176445
    ],
    [
     "2026-05-04",
     177792
    ],
    [
     "2026-05-11",
     224574
    ],
    [
     "2026-05-18",
     191444
    ],
    [
     "2026-05-25",
     183539
    ],
    [
     "2026-06-01",
     188097
    ],
    [
     "2026-06-08",
     204165
    ],
    [
     "2026-06-15",
     210918
    ],
    [
     "2026-06-22",
     187275
    ],
    [
     "2026-06-29",
     187169
    ],
    [
     "2026-07-06",
     195869
    ],
    [
     "2026-07-13",
     232631
    ],
    [
     "2026-07-20",
     252175
    ],
    [
     "2026-07-27",
     242563
    ],
    [
     "2026-08-03",
     217305
    ],
    [
     "2026-08-10",
     221720
    ],
    [
     "2026-08-17",
     210689
    ],
    [
     "2026-08-24",
     221453
    ],
    [
     "2026-08-31",
     252136
    ],
    [
     "2026-09-07",
     166223
    ],
    [
     "2026-09-14",
     200628
    ],
    [
     "2026-09-21",
     247005
    ],
    [
     "2026-09-28",
     284076
    ],
    [
     "2026-10-05",
     239907
    ],
    [
     "2026-10-12",
     198597
    ],
    [
     "2026-10-19",
     211320
    ],
    [
     "2026-10-26",
     313521
    ],
    [
     "2026-11-02",
     318950
    ],
    [
     "2026-11-09",
     294642
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     13949
    ],
    [
     "2026-11-08",
     13949
    ],
    [
     "2026-11-09",
     13950
    ],
    [
     "2026-11-10",
     13950
    ],
    [
     "2026-11-11",
     13954
    ],
    [
     "2026-11-12",
     13953
    ],
    [
     "2026-11-13",
     13953
    ],
    [
     "2026-11-14",
     13954
    ],
    [
     "2026-11-15",
     13957
    ],
    [
     "2026-11-16",
     13956
    ],
    [
     "2026-11-17",
     13958
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "nextra",
   "name": "Nextra",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "docusaurus",
   "name": "Docusaurus",
   "why": "Pick Docusaurus for a React docs generator with a ready classic template that has docs, a blog and a landing page.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "starlight",
   "name": "Starlight",
   "why": "Pick Starlight when you prefer Astro; it gives navigation, search, translations and dark mode out of the box.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "fumadocs",
   "name": "Fumadocs",
   "why": "Pick Fumadocs for a Next.js or React Router docs framework with ready templates and pages made from API descriptions.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "bootstrap-examples",
   "name": "Bootstrap Examples",
   "why": "Official Bootstrap 5 example snippets and layouts: heroes, features, pricing, headers, footers, dashboards; one zip download.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "vitepress",
   "name": "VitePress",
   "why": "Vite + Vue static site generator with a default docs theme and a home/landing layout.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Do I need to know Next.js?",
   "a": "A little. Nextra is a plugin for Next.js, so you need a Next.js project; the pages themselves are Markdown files."
  },
  {
   "q": "Does search need a server or a paid service?",
   "a": "No. Pagefind builds the search index after the site is built, and the search runs in the reader's browser."
  },
  {
   "q": "Can I host it as plain files, for example on GitHub Pages?",
   "a": "Yes, with a static export (output 'export' and unoptimized images in next.config.mjs)."
  },
  {
   "q": "Can I use it for a blog instead of docs?",
   "a": "Yes. Install nextra-theme-blog instead of nextra-theme-docs."
  },
  {
   "q": "Is it free for a company site?",
   "a": "Yes. It is MIT licensed."
  }
 ],
 "at_a_glance": {
  "latest_version": "4.6.1",
  "last_release": "2025-12-04",
  "last_commit": "2026-07-31",
  "runtime": "Next.js 14+, React 18+ and Node 18+; Nextra 4 needs the App Router; the theme package nextra-theme-docs (or nextra-theme-blog) must have the same version, 4.6.1.",
  "key_needed": false,
  "formats": "mdx, tsx"
 },
 "good_to_know": [
  "Nextra 4 works only with the newer Next.js App Router. Projects on the older Pages Router need Nextra 3 or earlier.",
  "Pages are written in MDX, a kind of Markdown where you can also place interactive parts, like a counter or a code playground.",
  "Nextra follows the system settings for more contrast and less motion.",
  "The latest version is 4.6.1, from December 2025. It needs Next.js 14 or newer, React 18 or newer and Node 18 or newer."
 ],
 "stack_snippets": [],
 "claims": [],
 "checked": {
  "license_read": "2026-11-09",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "nextra.site",
    "url": "https://nextra.site"
   },
   {
    "label": "nextra.site/docs",
    "url": "https://nextra.site/docs"
   },
   {
    "label": "nextra.site/docs/docs-theme/start",
    "url": "https://nextra.site/docs/docs-theme/start"
   },
   {
    "label": "nextra.site/docs/blog-theme/start",
    "url": "https://nextra.site/docs/blog-theme/start"
   },
   {
    "label": "nextra.site/docs/guide/search",
    "url": "https://nextra.site/docs/guide/search"
   },
   {
    "label": "nextra.site/docs/guide/i18n",
    "url": "https://nextra.site/docs/guide/i18n"
   },
   {
    "label": "nextra.site/docs/guide/static-exports",
    "url": "https://nextra.site/docs/guide/static-exports"
   },
   {
    "label": "nextra.site/docs/guide/markdown",
    "url": "https://nextra.site/docs/guide/markdown"
   },
   {
    "label": "nextra.site",
    "url": "https://nextra.site/docs/file-conventions/meta-file"
   },
   {
    "label": "nextra.site",
    "url": "https://nextra.site/docs/file-conventions/content-directory"
   },
   {
    "label": "github.com/shuding/nextra",
    "url": "https://github.com/shuding/nextra"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/shuding/nextra/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/shuding/nextra/blob/main/LICENSE"
   },
   {
    "label": "github.com/shuding/nextra/blob/main/examples/docs/package.json",
    "url": "https://github.com/shuding/nextra/blob/main/examples/docs/package.json"
   },
   {
    "label": "github.com/shuding/nextra-docs-template",
    "url": "https://github.com/shuding/nextra-docs-template"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/shuding/nextra-docs-template/blob/main/README.md"
   },
   {
    "label": "github.com/shuding/nextra-docs-template/blob/main/package.json",
    "url": "https://github.com/shuding/nextra-docs-template/blob/main/package.json"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/shuding/nextra-docs-template/main/LICENSE"
   },
   {
    "label": "npm: nextra",
    "url": "https://registry.npmjs.org/nextra"
   },
   {
    "label": "npm: nextra-theme-docs",
    "url": "https://registry.npmjs.org/nextra-theme-docs"
   },
   {
    "label": "npm: nextra-theme-blog",
    "url": "https://registry.npmjs.org/nextra-theme-blog"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/nextra/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
