docusaurus
v3.10.2Easy to maintain open source documentation websites.
- Maintenance
- Active350 commits in 3 months · bus factor 3
- License
- MITPermissive · OSI-approved
- Security
- No advisories publishedNothing published on GitHub
- Supported versions
- No scheduleendoflife.date does not track this project
66.7k stars · 10.1k forks · 431 open issues · last release 4 months ago · data checked 50 minutes ago
Breaking changes
What to check before upgrading, taken from the notes of the last 30 releases.
- v3.0.0Oct 31, 2023
:boom: Breaking Change
create-docusaurus,docusaurus-mdx-loader,docusaurus-plugin-content-blog,docusaurus-remark-plugin-npm2yarn,docusaurus-theme-classic- #9451 feat(mdx-loader): upgrade to MDX v3 (@slorber)
create-docusaurus,docusaurus-plugin-content-docs,docusaurus-plugin-ideal-image,docusaurus-types,docusaurus-utils,docusaurus- #9317 feat(core): support TypeScript + ESM configuration (@harryzcy)
create-docusaurus,docusaurus-theme-classic,docusaurus-theme-common,docusaurus-theme-live-codeblock,docusaurus- #9316 chore: upgrade syntax highlighting dependencies,
prism-react-rendererto v2,react-liveto v4 (@harryzcy) create-docusaurus,docusaurus-cssnano-preset,docusaurus-logger,docusaurus-mdx-loader,docusaurus-migrate,docusaurus-plugin-client-redirects,docusaurus-plugin-content-blog,docusaurus-plugin-content-docs,docusaurus-plugin-content-pages,docusaurus-plugin-debug,docusaurus-plugin-google-analytics,docusaurus-plugin-google-gtag,docusaurus-plugin-google-tag-manager,docusaurus-plugin-ideal-image,docusaurus-plugin-pwa,docusaurus-plugin-sitemap,docusaurus-preset-classic,docusaurus-remark-plugin-npm2yarn,docusaurus-theme-classic,docusaurus-theme-common,docusaurus-theme-live-codeblock,docusaurus-theme-mermaid,docusaurus-theme-search-algolia,docusaurus-theme-translations,docusaurus-utils-common,docusaurus-utils-validation,docusaurus-utils,docusaurus,eslint-plugin,lqip-loader- #9348 chore: update node engine version 18 (@OzakIOne)
docusaurus-plugin-content-docs,docusaurus-theme-classic- #9310 chore(plugin-docs): remove legacy versioned prefix on doc ids and sidebar names in versioned sidebars (@slorber)
docusaurus-theme-classic,docusaurus-theme-translations- #9308 fix(theme): make warning a first-class admonition, and deprecate caution admonition (@slorber)
docusaurus-theme-common,docusaurus-theme-live-codeblock,docusaurus-theme-mermaid- #9305 feat(theme-mermaid): upgrade Mermaid to v10.4 - handle async rendering (@slorber)
create-docusaurus,docusaurus-plugin-content-docs,docusaurus-plugin-debug,docusaurus-plugin-google-analytics,docusaurus-plugin-google-gtag,docusaurus-plugin-google-tag-manager,docusaurus-plugin-ideal-image,docusaurus-plugin-pwa,docusaurus-theme-classic,docusaurus-theme-common,docusaurus-theme-live-codeblock,docusaurus-theme-mermaid,docusaurus-theme-search-algolia,docusaurus-tsconfig,docusaurus- #9258 feat: Docusaurus v3 upgrades and require TypeScript 5 (@slorber)
docusaurus-plugin-content-blog- #9189 feat(blog-plugin): limit option for blog feedOptions (@johnnyreilly)
create-docusaurus,docusaurus-tsconfig- #9050 feat: create official TypeScript base config @docusaurus/tsconfig (@slorber)
create-docusaurus,docusaurus-mdx-loader,docusaurus-module-type-aliases,docusaurus-plugin-client-redirects,docusaurus-plugin-content-blog,docusaurus-plugin-content-docs,docusaurus-plugin-content-pages,docusaurus-plugin-debug,docusaurus-plugin-google-analytics,docusaurus-plugin-google-gtag,docusaurus-plugin-google-tag-manager,docusaurus-plugin-ideal-image,docusaurus-plugin-pwa,docusaurus-plugin-sitemap,docusaurus-preset-classic,docusaurus-theme-classic,docusaurus-theme-common,docusaurus-theme-live-codeblock,docusaurus-theme-mermaid,docusaurus-theme-search-algolia,docusaurus-types,docusaurus- #8961 feat: React 18 + automatic JSX runtime + build --dev (@slorber)
create-docusaurus
Release history
All releases on GitHubAtom feed/feed/meta/docusaurus
Badge
[](/p/meta/docusaurus)
3.10.2 (2026-07-10)
Backport and cherry-pick commits from main for v3.10.2 patch release:
- fix(bundler): do not import
@swc/html, fix StackBlitz playground \#12055 - fix(core): use locale url in site config \#12054
- fix(theme-classic): remove redundant sidebar label titles \#11966
- fix(mdx-loader): avoid transforming dotted directory links into asset… \#11944
- fix(dev-server): for HTTPS, support non-RSA TLS certs \#12065
- fix(utils): fix
extractLeadingEmoji()edge cases \#12100 - fix(gtag.js, faster): Fix StackBlitz, vendor
@types/gtag.js, upgrade@swc/html\#12080 - fix(create-docusaurus): init template README should use npm commands by default \#12138
- fix(cli):
docusaurus serveshould pass--hosttoserver.listen()\#12127 - fix(core): bump detect-port to v2.1, fix pnpm
trustPolicydowngrade issue \#12012 - fix(i18n): complete Spanish translations for theme-common and theme-l… \#12180
- chore(deps): migrate to
@11ty/gray-matter\#12181 - fix(core): fix BaseUrlIssueBanner little security issue \#12260
- fix(core): accept boolean attributes in headTags config validation \#12238
- fix(sitemap): don't drop lastmod for an epoch (0) timestamp \#12212
- fix(utils): preserve author names containing commas in git log parsing \#12069