Docusaurus v3.8.0

3.8.0 (2025-05-26)

:rocket: New Feature

• docusaurus-plugin-css-cascade-layers, docusaurus-preset-classic, docusaurus-theme-classic, docusaurus-types, docusaurus
  • #11142 feat(theme): new CSS cascade layers plugin + built-in v4.useCssCascadeLayers future flag (@slorber)
• docusaurus
  • #11156 feat(core): add internal flag to skip bundling (@slorber)
  • #11067 feat(core): enable Rspack parallelCodeSplitting (@slorber)
• docusaurus-module-type-aliases, docusaurus-plugin-content-blog, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus
  • #11090 feat(theme): make it possible to provide your own page title formatter (@slorber)
• docusaurus-plugin-content-pages
  • #11088 feat(pages): Support frontMatter.slug like docs and blog plugins (@slorber)
• docusaurus-faster, docusaurus
  • #11006 feat(core): Add bundler tracing/profiling (@slorber)
• docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
  • #10987 feat(theme): Allow resetting colorMode to System/OS value (@slorber)
• docusaurus-remark-plugin-npm2yarn
  • #10953 feat(plugin-npm2yarn): Add Bun to default tabs conversions (@jakeboone02)
• docusaurus-theme-classic, docusaurus-theme-common
  • #10945 feat(theme): add theme layout stable CSS classes (@slorber)
  • #10846 feat(theme): code block showLineNumbers=start metastring (@slorber)
• docusaurus-faster, docusaurus-plugin-content-docs, docusaurus-types, docusaurus
  • #10931 feat(core): Docusaurus Faster - Rspack Persistent Cache (@slorber)
• docusaurus-theme-classic
  • #10852 feat(theme): add versions attribute to docsVersionDropdown navbar item (@hrumhurum)
• docusaurus-types, docusaurus
  • #10826 feat(core): Docusaurus Faster - SSG worker threads (@slorber)
• docusaurus-plugin-sitemap, docusaurus-types, docusaurus
  • #10850 feat(core): new postBuild({routesBuildMetadata}) API, deprecate head attribute + v4 future flag (@slorber)

:bug: Bug Fix

• docusaurus-plugin-content-blog
  • #11138 refactor(content-blog): replace reading-time with Intl.Segmenter API (@shreedharbhat98)
• docusaurus-plugin-content-blog
  • #11138 refactor(content-blog): replace reading-time with Intl.Segmenter API (@shreedharbhat98)
  • #11068 fix(blog): fix blog Atom feed item url / XSL bug (@slorber)
• docusaurus-plugin-content-docs
  • #11179 fix(mdx-loader): remove opt-in for mdx dependency file (@slorber)
  • #10875 fix(docs): versioning CLI should copy localized translation file current.json to version-<v>.json (@jkboxomine)
• create-docusaurus
  • #11157 fix(create-docusaurus): Improve init template README, fix headings and remove $ in bash code blocks (@arienshibani)
• docusaurus-theme-common
  • #11153 fix(theme): restore former code block theme-common internal APIs (@slorber)
  • #11046 fix(theme): Fix code block magic comments with CRLF line breaks bug (@coder-xiaomo)
  • #10989 fix(theme): mobile drawer history blocker should be rendered conditionally (workaround) (@slorber)
  • #10954 fix(theme): fix useColorMode().colorMode leading to React hydration mismatches (@slorber)
• docusaurus-theme-classic
  • #11085 fix(theme): add missing rel="tag" attribute for docs/blog tags (@slorber)
  • #10999 fix(theme): CodeBlock should accept title of ReactNode type (@lebalz)
  • #10705 fix(theme): only render secondaryMenu if it should be shown (@hidde)
  • #10898 fix(theme): a11y fix on mobile DropdownNavbarItem (@mxschmitt)
  • #10909 fix(theme): apply docs sidebar_class_name in DocCard + better dogfooding (@slorber)
  • #10849 fix(theme): fix <DocCard> height inconsistency (@hichemfantar)
  • #10866 fix(theme): Hide code block buttons before React hydration (@kennethormandy)
• docusaurus-theme-classic, docusaurus-theme-translations
  • #11053 fix(theme): navbar mobile sidebar should allow clicking dropdown parent link (@slorber)
• docusaurus-utils
  • #11027 fix(cli): fix CLI write-translation bug (@slorber)
• docusaurus-theme-translations
  • #11030 fix(theme-translation): add missing Japanese translation for System Mode (@tats-u)
  • #10893 fix(theme-translations): Turkish exist language translate completed. (@ramazansancar)
  • #10884 fix(theme-translations): Add missing Polish (pl) theme translations (@mariuszkrzaczkowski)
• docusaurus-plugin-ideal-image
  • #11026 fix(ideal-image): fix waypoint initial scroll bug (@slorber)
  • #11014 fix(ideal-image): Internalize react-waypoint dependency, fix React 19 compatibility (@slorber)
  • #10910 fix(ideal-image): Add issuer to ideal-image Webpack loader (@slorber)
• docusaurus-mdx-loader
  • #11004 fix(mdx-loader): refactor and fix heading to toc html value serialization (@slorber)
• docusaurus-module-type-aliases
  • #10998 fix(module-type-aliases): pin react-helmet-async to @slorber/react-helmet-async@1.3.0 (@cylewaitforit)
• docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
  • #10987 feat(theme): Allow resetting colorMode to System/OS value (@slorber)
• create-docusaurus, docusaurus-utils
  • #10958 fix(create-docusaurus): fix CLI and remove shelljs escapeShellArg util (@slorber)
• docusaurus-mdx-loader, docusaurus-plugin-content-docs
  • #10934 fix(docs): fix mdx loader cache invalidation bug on versions changes (@slorber)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages
  • #10929 fix(plugins): add missing validateOptions types (@slorber)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common
  • #10888 fix(seo): docs breadcrumb structured data should use JSON-LD and filter unliked categories (@johnnyreilly)
• docusaurus-theme-classic, docusaurus-theme-common
  • #10886 fix(theme): collapse doc sidebar category on label click if active (@slorber)
• docusaurus
  • #10915 fix(core): use os.availableParallelism() for SSG worker threads count (@slorber)
• docusaurus-plugin-content-docs, docusaurus-theme-classic
  • #10847 fix(theme): Fix <DocCardList> usage on docs at root of a sidebar (@slorber)
• docusaurus-plugin-svgr, docusaurus-types, docusaurus-utils, docusaurus
  • #10820 fix(core): restore core svg file-loader (@slorber)
• docusaurus-logger
  • #10818 fix: perflogger mark detail bug (@slorber)

:running_woman: Performance

• docusaurus-utils, docusaurus
  • #11178 perf(core): disable Rspack parallelCodeSplitting temporarily (@slorber)
• docusaurus
  • #11177 perf(core): fix bad value for mergeDuplicateChunks (typo) (@slorber)
  • #11170 perf(core): add default for DOCUSAURUS_SSG_WORKER_THREAD_RECYCLER_MAX_MEMORY (@slorber)
  • #11166 feat(core): expose opt-in env variable for SSG thread recycling (@slorber)
  • #11072 perf(core): remove bundler optimization.removeAvailableModules (@slorber)
  • #11067 feat(core): enable Rspack parallelCodeSplitting (@slorber)
  • #11037 refactor(core): remove clean-webpack-plugin (@slorber)
  • #11007 perf(core): Optimize docusaurus start/serve, fix openBrowser() perf issue on macOS (@slorber)
• docusaurus-bundler, docusaurus-faster, docusaurus
  • #11176 perf(bundler): fine-tuning of Webpack/Rspack optimizations (@slorber)
• docusaurus-utils
  • #11163 perf(utils): implement git command queue (@slorber)
• docusaurus-logger, docusaurus
  • #11162 perf(core): optimize SSG collected data memory and worker thread communication (@slorber)
• docusaurus-bundler, docusaurus
  • #10956 refactor: remove react-dev-utils (CRA) dependency, internalize code (@slorber)
• docusaurus-theme-classic
  • #10885 perf(theme): use SVG sprite for IconExternalLink (@slorber)
• docusaurus-types, docusaurus
  • #10826 feat(core): Docusaurus Faster - SSG worker threads (@slorber)

:nail_care: Polish

• docusaurus-theme-live-codeblock
  • #11120 fix(theme): improve color contrast of live code block header (@JackHowa)
• docusaurus-theme-translations
  • #10825 fix(theme-translations): Add missing Polish (pl) theme translations (@mariuszkrzaczkowski)
  • #10816 chore(theme-translations): add missing zh theme translations (@MisterFISHUP)

:memo: Documentation

• #11181 docs: adjust the Docusaurus release process documentation to our new simpler process (@slorber)
• #11180 docs(ideal-image): Add warning for pnpm 10+ and sharp install script (@slorber)
• #11137 docs(deploy): remove layer0 from deployment docs (@PaiJi)
• #10822 docs(website): Comparison with Rspress (@DevJoaoLopes)

:robot: Dependencies

• #11185 chore(deps): bump actions/dependency-review-action from 4.7.0 to 4.7.1 (@dependabot[bot])
• #11182 chore(deps): bump lockfile-lint-api from 5.9.1 to 5.9.2 (@dependabot[bot])
• #11174 chore(deps): bump actions/dependency-review-action from 4.6.0 to 4.7.0 (@dependabot[bot])
• #11135 chore(deps): bump http-proxy-middleware from 2.0.7 to 2.0.9 (@dependabot[bot])
• #11103 chore(deps): bump marocchino/sticky-pull-request-comment from 2.9.1 to 2.9.2 (@dependabot[bot])
• #11102 chore(deps): bump actions/setup-node from 4.3.0 to 4.4.0 (@dependabot[bot])
• #11070 chore(deps): bump estree-util-value-to-estree from 3.1.2 to 3.3.3 (@dependabot[bot])
• #11069 chore(deps): bump actions/dependency-review-action from 4.5.0 to 4.6.0 (@dependabot[bot])
• #11002 chore(deps): bump actions/setup-node from 4.2.0 to 4.3.0 (@dependabot[bot])
• #10990 chore(deps): bump @babel/runtime-corejs3 from 7.25.9 to 7.26.10 (@dependabot[bot])
• #10970 chore(deps): bump axios from 1.7.7 to 1.8.2 (@dependabot[bot])
• #10978 chore(deps): bump prismjs from 1.29.0 to 1.30.0 (@dependabot[bot])
• #10957 chore(deps): bump http-proxy-middleware from 2.0.6 to 2.0.7 (@dependabot[bot])
• #10937 chore(deps): bump dompurify from 3.1.6 to 3.2.4 (@dependabot[bot])
• #10936 chore(deps): bump preactjs/compressed-size-action from 2.7.0 to 2.8.0 (@dependabot[bot])
• #10873 chore(deps): bump actions/setup-node from 4.1.0 to 4.2.0 (@dependabot[bot])
• #10853 chore(deps): bump marocchino/sticky-pull-request-comment from 2.9.0 to 2.9.1 (@dependabot[bot])
• #10851 chore(deps): bump katex from 0.16.11 to 0.16.21 (@dependabot[bot])

:wrench: Maintenance

• docusaurus-mdx-loader, docusaurus-utils
  • #11168 chore: add Node 24 to CI + fix deprecation warnings (@slorber)
• docusaurus-plugin-content-blog
  • #11116 test(blog): Add unit tests for calculating blog posts reading time (@shreedharbhat98)
• docusaurus-mdx-loader, docusaurus-theme-common, docusaurus-theme-live-codeblock
  • #11077 refactor(live-codeblock): refactor live code block theme components (@slorber)
• Other
  • #11075 fix(c): fix yarn lint:spelling:fix script (@slorber)
• docusaurus-faster
  • #11073 chore: upgrade Rspack 1.3.3 (@slorber)
  • #10870 chore(deps): bump @rspack/core in Faster from 1.2.0-alpha.0 to 1.2.2 (@tats-u)
• docusaurus-theme-mermaid
  • #11066 chore: upgrade mermaid, fix diagram labels bug (@slorber)
• docusaurus-mdx-loader
  • #11065 chore: upgrade image-size deps to v2 (@slorber)
• docusaurus-theme-classic, docusaurus-theme-common
  • #11062 refactor(theme): introduce CodeBlockContextProvider + split into smaller components (@slorber)
  • #11059 refactor(theme): CodeBlock, centralize metadata parsing + refactor theme component (@slorber)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-common
  • #11058 refactor(theme): refactor CodeBlock parseLines logic + use inline snapshots to ease review (@slorber)
• docusaurus-faster, docusaurus
  • #11039 chore: use rspack 1.3.0 (@slorber)
• docusaurus-plugin-ideal-image
  • #11010 refactor(ideal-image-plugin): internalize legacy component code (@slorber)
• docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-mermaid, docusaurus-theme-search-algolia
  • #10969 chore: add eslint-plugin-react-compiler (@slorber)
• docusaurus-cssnano-preset, docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-remark-plugin-npm2yarn, eslint-plugin, stylelint-copyright
  • #10966 chore: upgrade monorepo to TS 5.8 (@slorber)
• docusaurus-bundler, docusaurus
  • #10956 refactor: remove react-dev-utils (CRA) dependency, internalize code (@slorber)
• create-docusaurus, docusaurus-plugin-content-docs, docusaurus-utils, docusaurus
  • #10358 refactor: replace unmaintained shelljs dependency by execa (@OzakIOne)
• docusaurus-theme-search-algolia
  • #10941 chore(algolia): bump docsearch dependency to v3.9 (@slorber)
• docusaurus-plugin-debug
  • #10903 chore(plugin-debug): upgrade react-json-view-lite to v2.3.0 for react 19 (@reece-white)
  • #10819 chore(plugin-debug): upgrade react-json-view-lite to v2, prepare for React 19 (@slorber)
• create-docusaurus
  • #10871 refactor(create-docusaurus): add future.v4 flag to init templates (@slorber)

Committers: 38

• Arien Shibani (@arienshibani)
• Balthasar Hofer (@lebalz)
• Ben McCann (@benmccann)
• Daniel Kuschny (@Danielku15)
• David King Roderos (@dkroderos)
• FISH UP (@MisterFISHUP)
• Hichem Fantar (@hichemfantar)
• Hidde de Vries (@hidde)
• Jack Howard (@JackHowa)
• Jake Boone (@jakeboone02)
• JiPai (@PaiJi)
• John Reilly (@johnnyreilly)
• Joshua Chen (@Josh-Cena)
• João Victor Lopes (@DevJoaoLopes)
• Justin D Mathew (@JDMathew)
• Kenneth Ormandy (@kennethormandy)
• Mariusz Krzaczkowski (@mariuszkrzaczkowski)
• Massoud Maboudi (@massoudmaboudi)
• Max Schmitt (@mxschmitt)
• Milica (@mmaksimovic)
• Oleksiy Gapotchenko (@hrumhurum)
• Ramazan Sancar (@ramazansancar)
• Shreedhar Bhat (@shreedharbhat98)
• Stephen Glass (@stephenglass)
• Sébastien Lorber (@slorber)
• Taras (@taraspos)
• Tatsunori Uchino (@tats-u)
• Waldir Pimenta (@waldyrious)
• Yangshun Tay (@yangshun)
• Yoshiaki Yoshida (@kakakakakku)
• @cylewaitforit
• @jkboxomine
• @reece-white
• kilavvy (@kilavvy)
• ozaki (@OzakIOne)
• pedenys (@pedenys)
• マルコメ (@Marukome0743)
• 程序员小墨 (@coder-xiaomo)