Docusaurus
by Meta Open Source
Open-source docs-site generator with a ready classic template (docs, blog, landing page); React + MDX.
Page and site templates Code libraryOpen sourceminimal
1. Price: docusaurus.io
Fully free.
docusaurus.ioNo quote yet: price is read from the official pages.
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, change and sale, including for paid products.
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/meta/docusaurus
An agent can install it by itself with npm install create-docusaurus. No key or account is needed.
github.com/meta/docusaurusLicense checked Nov 5, 2026 against 1 official page. Tap a verdict to see its source. How we checked Report an error
Docusaurus: a docs website built from text files
Docusaurus is a free tool from Meta that turns folders of Markdown text files into a documentation website with a sidebar, a blog and extra pages. You or your AI assistant write the texts, and it builds ready web pages for any web hosting. Translations, docs for each release and dark mode are built in.
Where you can use it
Docs site for your product
Put guides, how-tos and reference pages for your app or library on one site with a sidebar. You add a page by adding a text file.
A blog next to the docs
Post release notes and articles as dated text files. The blog gets its own list page, and only the part above a marker shows as the summary.
The same docs in several languages
Offer the site in English and French, or in a right-to-left language such as Persian, with a language menu in the top bar.
Docs for each release
Keep the docs for version 1.0 readable while you write the docs for 2.0. Readers pick their version from a menu.
Landing page or personal site
Use the same tool for a product landing page, a personal site or a blog that has no docs at all.
Help center for your app users Idea
Write help articles for customers, such as how to change a plan or export data, and link to them from inside your app.
Docusaurus 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
“Create a Docusaurus 3.10.2 site with the classic template in a website/ folder, keep every @docusaurus package on that exact version, set url and baseUrl for our domain, and move our guides into docs/ as Markdown files.”
Or install it yourself. With Node.js 20 or newer installed, create a site from the classic template (docs, blog, pages and dark mode).
npx create-docusaurus@latest my-website classic
Show codeStep 1 or Step 2
Start the preview server; pages update as you edit the files.
cd my-website
npm run start
Build the site; the build folder holds plain web files you can upload to any static hosting.
npm run build
Mistakes to avoid
The packages are released together and are meant to match.
Links and files load from the wrong place when the site lives in a subfolder.
Only the config file runs in Node.js; pages run in the browser and have no process variable.
MDX files use a different comment syntax, so the summary cut does not work.
Versioning makes builds slower and editing harder.
License
MIT license. License, so it is free for personal and paid sites, and your site needs no visible credit. Keep the copyright and license notice if you pass on copies of the Docusaurus code.
“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 Docusaurus 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 Docusaurus. Paste them into your prompt or AGENTS.md.
- Docusaurus (Page and site templates). Open-source docs-site generator with a ready classic template (docs, blog, landing page); React + MDX. Price: free; commercial use OK; no credit needed. Style: minimal.
Connect: npm create-docusaurus.
Get files: npm init docusaurus@latest (pick the classic template); no account (mdx, jsx, css).
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://raw.githubusercontent.com/facebook/docusaurus/main/LICENSE (checked 2026-11-05; details: https://agentgid.com/assets/docusaurus/)
Agent installs a package or loads it from a CDN.
npm install create-docusaurusFormats: mdx, jsx, css
Built with Docusaurus.Alternatives
Docusaurus This page
Pick VitePress when your project uses Vue instead of React; the Docusaurus docs name it the Vue choice.
Pick Starlight for an Astro docs site with navigation, search, translations and dark mode ready out of the box.
Pick Nextra when your app already runs on Next.js and you want the docs in the same stack.
Official Bootstrap 5 example snippets and layouts: heroes, features, pricing, headers, footers, dashboards; one zip download.
Vue/Nuxt UI library (125+ components, Reka UI + Tailwind) with page-level components and MIT starter templates: landing, SaaS, docs, dashboard.
Questions
Do I need to know React to use it?
No. You write docs and blog posts as Markdown files; React is only needed to build custom pages or change the layout.
Can I use it for a paid product or a client site?
Yes. The MIT license allows use, change and sale; keep the license notice with copies of its code.
Does the finished site need a server with Node.js?
No. The build is a folder of static files, and the site generally works even without JavaScript.
Can I try it without installing anything?
Yes. The docs point to docusaurus.new, a playground that runs in the browser.
Is it only for docs?
No. It can make any kind of site, such as a personal site, a blog or a landing page.