# Docusaurus — card for AI agents

Open-source docs-site generator with a ready classic template (docs, blog, landing page); React + MDX.

Category: Page and site templates · maker Meta Open Source · checked 2026-11-05 · style: minimal

## Price
- Price: Free
- Free tier: Fully free.

## License
MIT — https://raw.githubusercontent.com/facebook/docusaurus/main/LICENSE

- commercial: **yes** (Commercial use OK)
  > 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
  (https://raw.githubusercontent.com/facebook/docusaurus/main/LICENSE)
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
  (https://raw.githubusercontent.com/facebook/docusaurus/main/LICENSE)
- in app: **yes** (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
  (https://raw.githubusercontent.com/facebook/docusaurus/main/LICENSE)
- redistribute: **yes** (Can pass the files on to your own users)
  > 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
  (https://raw.githubusercontent.com/facebook/docusaurus/main/LICENSE)

## Rules to follow
- Keep the MIT copyright notice in the code if you redistribute it.
- No visible credit on the site is required by the licence.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How an agent gets files
- npm init docusaurus@latest (pick the classic template); no account. (sign-in: none)
- Formats: mdx, jsx, css
- Not allowed: Needs Node.js

## How to connect
- Package (npm/PyPI)
- npm: `npm install create-docusaurus`
- Repository: https://github.com/meta/docusaurus
- Website: https://docusaurus.io

## Numbers (AgentGid data)
- Gid Score: 34
- GitHub stars: 66,749
- Downloads last week: 6,699

## Lines to paste 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/)
```

## Links
- AgentGid page: https://agentgid.com/assets/docusaurus/
- Is it free for commercial use? https://agentgid.com/assets/docusaurus/commercial-use/
- Source: https://docusaurus.io
- Source: https://github.com/facebook/docusaurus
- Source: https://raw.githubusercontent.com/facebook/docusaurus/main/LICENSE


## 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 to 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: Write help articles for customers, such as how to change a plan or export data, and link to them from inside your app. (idea, not from the official pages)

### How to start
- 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
```

- 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
```


### License
MIT 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.

### Good to know
- Building the site needs Node.js 20 or newer on your computer or build server. Visitors only get plain web pages.
- Docusaurus only builds the files; where you host them is your choice, for example GitHub Pages, Netlify or Vercel.
- The official search uses Algolia DocSearch. It is free for developer docs, but you have to apply for it first.
- Docs for each release make builds slower and the project harder to edit. The docs advise skipping them when the docs rarely change.
- Each language is built as a separate site, so the preview shows one language at a time.

Checked 2026-11-09 against: https://docusaurus.io/, https://docusaurus.io/docs, https://docusaurus.io/docs/installation, https://docusaurus.io/docs/blog, https://docusaurus.io/docs/i18n/introduction, https://docusaurus.io/docs/i18n/tutorial, https://docusaurus.io/docs/versioning, https://docusaurus.io/docs/search, https://docusaurus.io/docs/deployment, https://docusaurus.io/docs/creating-pages, https://docusaurus.io/docs/seo, https://github.com/facebook/docusaurus/blob/main/README.md, https://github.com/facebook/docusaurus/blob/main/LICENSE, https://registry.npmjs.org/@docusaurus/core/latest, https://registry.npmjs.org/create-docusaurus/latest

### Mistakes to avoid
- Don't: Updating only @docusaurus/core (for example to 3.10.2) and leaving @docusaurus/preset-classic on an older version → Do: Set every @docusaurus/* package in package.json to the same exact version, then run npm install (The packages are released together and are meant to match.)
- Don't: url: 'https://my-org.com/my-project' with baseUrl: '/' → Do: url: 'https://my-org.com/' and baseUrl: '/my-project/' (with the trailing slash) (Links and files load from the wrong place when the site lives in a subfolder.)
- Don't: Reading process.env.MY_VALUE inside a React page or MDX file → Do: Read the variable in docusaurus.config.js, put it in customFields and read it with useDocusaurusContext() (Only the config file runs in Node.js; pages run in the browser and have no process variable.)
- Don't: Writing the HTML comment truncate marker in a .mdx blog post → Do: In .mdx files use the MDX comment form {/* truncate */}; the HTML comment form is for .md files (MDX files use a different comment syntax, so the summary cut does not work.)
- Don't: Turning on docs versioning for a small project from day one → Do: Add versions only when the docs change a lot between releases (Versioning makes builds slower and editing harder.)

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

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
