Docusaurus

Developer Tools

A documentation site generator built on React, with versioning and search.

Latest v3.10.2 · by MetaWebsitefacebook/docusaurus

Release activity

Release activity — 6 releases across 6 days in the last year. Each cell is one day; darker means more releases that day. Older weeks are hidden at this screen width.
MayJunJulAug
SundayNo releases on Apr 26, 2026No releases on May 3, 2026No releases on May 10, 2026No releases on May 17, 2026No releases on May 24, 2026No releases on May 31, 2026No releases on Jun 7, 2026No releases on Jun 14, 2026No releases on Jun 21, 2026No releases on Jun 28, 2026No releases on Jul 5, 2026No releases on Jul 12, 2026No releases on Jul 19, 2026No releases on Jul 26, 2026No releases on Aug 2, 2026No releases on Aug 9, 2026
MondayNo releases on Apr 27, 2026No releases on May 4, 2026No releases on May 11, 2026No releases on May 18, 2026No releases on May 25, 2026No releases on Jun 1, 2026No releases on Jun 8, 2026No releases on Jun 15, 2026No releases on Jun 22, 2026No releases on Jun 29, 2026No releases on Jul 6, 2026No releases on Jul 13, 2026No releases on Jul 20, 2026No releases on Jul 27, 2026No releases on Aug 3, 2026No releases on Aug 10, 2026
TuesdayNo releases on Apr 28, 2026No releases on May 5, 2026No releases on May 12, 2026No releases on May 19, 2026No releases on May 26, 2026No releases on Jun 2, 2026No releases on Jun 9, 2026No releases on Jun 16, 2026No releases on Jun 23, 2026No releases on Jun 30, 2026No releases on Jul 7, 2026No releases on Jul 14, 2026No releases on Jul 21, 2026No releases on Jul 28, 2026No releases on Aug 4, 2026No releases on Aug 11, 2026
WednesdayNo releases on Apr 29, 2026No releases on May 6, 2026No releases on May 13, 2026No releases on May 20, 2026No releases on May 27, 2026No releases on Jun 3, 2026No releases on Jun 10, 2026No releases on Jun 17, 2026No releases on Jun 24, 2026No releases on Jul 1, 2026No releases on Jul 8, 2026No releases on Jul 15, 2026No releases on Jul 22, 2026No releases on Jul 29, 2026No releases on Aug 5, 2026No releases on Aug 12, 2026
Thursday1 release on Apr 30, 2026No releases on May 7, 2026No releases on May 14, 2026No releases on May 21, 2026No releases on May 28, 2026No releases on Jun 4, 2026No releases on Jun 11, 2026No releases on Jun 18, 2026No releases on Jun 25, 2026No releases on Jul 2, 2026No releases on Jul 9, 2026No releases on Jul 16, 2026No releases on Jul 23, 2026No releases on Jul 30, 2026No releases on Aug 6, 2026
FridayNo releases on May 1, 2026No releases on May 8, 2026No releases on May 15, 2026No releases on May 22, 2026No releases on May 29, 2026No releases on Jun 5, 2026No releases on Jun 12, 2026No releases on Jun 19, 2026No releases on Jun 26, 2026No releases on Jul 3, 20261 release on Jul 10, 2026No releases on Jul 17, 2026No releases on Jul 24, 2026No releases on Jul 31, 2026No releases on Aug 7, 2026
SaturdayNo releases on May 2, 2026No releases on May 9, 2026No releases on May 16, 2026No releases on May 23, 2026No releases on May 30, 2026No releases on Jun 6, 2026No releases on Jun 13, 2026No releases on Jun 20, 2026No releases on Jun 27, 2026No releases on Jul 4, 2026No releases on Jul 11, 2026No releases on Jul 18, 2026No releases on Jul 25, 2026No releases on Aug 1, 2026No releases on Aug 8, 2026

6 releases in the last year

Changelog

v3.10.2

3.10.2

Changed 2
  • Spanish translations completed for theme-common and theme-classic
  • Migrate to @11ty/gray-matter
Fixed 13
  • Bundler no longer imports @swc/html, fixing StackBlitz playground issues
  • Core now uses locale URL in site config
  • Theme-classic removes redundant sidebar label titles
  • MDX-loader avoids transforming dotted directory links into assets
  • Dev-server supports non-RSA TLS certificates for HTTPS
  • Utils function extractLeadingEmoji() edge cases fixed
Security 1
  • Core fixes BaseUrlIssueBanner security issue
View originalPermalink
How v3.10.2 went
v3.10.1

3.10.1

Fixed 1
  • Fix v3 webpackbar bug due to webpack breaking change
3.10.1 (2026-04-30)
:bug: Bug Fix
  • docusaurus-bundler
    • #11981 fix(bundler): fix v3 webpackbar bug due to webpack breaking change (@slorber)
:wrench: Maintenance
  • docusaurus
    • #11982 chore: cherry-pick commits for v3.10.1 patch release (@slorber)
Committers: 1
View originalPermalink
How v3.10.1 went
v3.10.0

3.10.0

Added 15
  • Add `future.v4.mdx1CompatDisabledByDefault` flag
  • Promote `siteConfig.storage` to stable and add `future.v4.siteStorageNamespacing` flag
  • Support custom html elements in head tags
  • Enable creation of Docusaurus sites in current directory
  • Improve npm supply chain security with improved Dependabot config
  • Use trusted publishing (OIDC) for canary releases
Changed 6
  • Update init template to `.mdx` extension and strict MDX syntax
  • Newly initialized TypeScript sites now use strict: true
  • Docusaurus Faster is stable and v4 future flag turns it on by default
  • Split `<DocCard>`, improve extensibility, better handling of emoji icons, and stabilize classNames
  • Use React context for `<Tabs>` and allow custom `<TabItem>` components
  • Upgrade to Rspack 1.7 and remove useless experimental feature flags
3.10.0 (2026-04-07)
:rocket: New Feature
  • docusaurus-types, docusaurus
    • #11896 feat(core): add future.v4.mdx1CompatDisabledByDefault flag (@slorber)
    • #11797 feat(core): promote siteConfig.storage to stable + add future.v4.siteStorageNamespacing flag [Claude] (@slorber)
    • #11571 feat(core): support custom html elements in head tags (@lebalz)
  • create-docusaurus
    • #11897 feat(create-docusaurus): update init template to .mdx extension and strict MDX syntax (@slorber)
    • #11696 feat(create-docusaurus): Newly initialized TS sites should use "strict: true" (@slorber)
    • #11611 feat(create-docusaurus): enable creation in current directory (@Mcheung7272)
  • Other
    • #11874 feat(ci): improve npm supply chain security - improve Dependabot config (@slorber)
    • #11712 feat(publish): Use trusted publishing (OIDC) for canary releases (@slorber)
  • create-docusaurus, docusaurus-bundler, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-pwa, docusaurus-types, docusaurus
    • #11802 feat(core): Docusaurus Faster is stable + v4 future flag turns it on by default (@slorber)
  • docusaurus-mdx-loader, docusaurus-utils, docusaurus
    • #11777 feat(cli): write-heading-ids CLI now supports the --syntax and --migrate options (@slorber)
  • docusaurus-mdx-loader
    • #11755 feat(mdx-loader): add support for explicit headingId based on MD/MDX comments (@slorber)
  • docusaurus-theme-live-codeblock, docusaurus-theme-translations
    • #11675 feat(theme-live-codeblock): reset button + wire position prop (@NPX2218)
  • docusaurus-theme-classic, docusaurus-theme-common
    • #11734 feat(theme): Split <DocCard>, improve extensibility, better handling of emoji icons, stable classNames (@slorber)
    • #11733 feat(theme): Use React context for <Tabs>, allow custom <TabItem> components (@slorber)
  • docusaurus-faster, docusaurus
    • #11715 feat(bundler): upgrade to Rspack 1.7, remove useless experimental feature flags (@slorber)
  • docusaurus-plugin-content-pages
  • docusaurus-mdx-loader, docusaurus-theme-classic
    • #11642 feat(mdx-loader): add admonitions directive support for class/id shortcuts (@lebalz)
  • docusaurus-theme-classic
  • docusaurus-theme-search-algolia
    • #11581 feat(theme-search-algolia): allow overriding transformSearchClient (@hugohaggmark)
    • #11541 feat(theme-search-algolia): add support for DocSearch v4.3.2 and new Suggested Questions (@NatanTechofNY)
  • create-docusaurus, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-sitemap, docusaurus-types, docusaurus-utils, docusaurus
    • #11512 feat(core): New siteConfig future.experimental_vcs API + future.experimental_faster.gitEagerVcs flag (@slorber)
:bug: Bug Fix
  • docusaurus
    • #11844 fix(core): fix url.resolve() Node.js deprecation warning (@slorber)
    • #11833 fix(core): upgrade serve handler min version to for upgrade users to a secure version (@BearAlliance)
    • #11763 fix(cli): fix write-heading-ids CLI when no files provided (@slorber)
    • #11693 fix(core): Remove deprecated experiments.lazyBarrel config for RsPack (@VedikaGupt)
    • #11604 fix(core): webpack aliases shouldn't be created for test files and typedefs (@slorber)
    • #11603 fix(core): Fix openBrowser AppleScript support for Arc (@slorber)
    • #11579 fix(core): in isInternalUrl(), URI protocol scheme detection should implement the spec more strictly (@slorber)
    • #11550 fix(core): optimize i18n integration for site builds + improve inference of locale config (@slorber)
  • docusaurus-faster, docusaurus
  • create-docusaurus, docusaurus-logger, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-google-gtag, docusaurus-plugin-pwa, docusaurus
    • #11843 fix(create-docusaurus): fix support for TypeScript 6.0 + fix our CI (@slorber)
  • docusaurus-utils
  • docusaurus-theme-classic
    • #11796 fix(theme): restore copy-text-to-clipboard as lazy fallback for non-secure contexts (@dmoranp)
    • #11513 fix(a11y): add Space key support for navbar dropdowns (@TheCyperpunk)
    • #11565 fix(theme): Change code block line from span to div, fix Firefox text selection/copy bug (@slorber)
  • docusaurus-plugin-content-docs
    • #11794 fix(content-docs): translate generated-index category titles in pagination links (@dmoranp)
    • #11743 fix(content-docs): use category key for generated-index translation lookup (@4RH1T3CT0R7)
    • #11616 fix(docs): breadcrumb APIs only return category/docs items, ignoring links (@Chesars)
  • docusaurus-plugin-google-gtag
  • docusaurus-theme-search-algolia
    • #11683 fix(algolia): upgrade to DocSearch 4.5 + fix types (@slorber)
    • #11560 fix(theme-search-algolia): preserve query strings in useSearchResultUrlProcessor (@pyrytakala)
  • docusaurus-plugin-content-blog
    • #11736 fix(content-blog): fix wrong path variable in feed XSLT CSS file validation (@akshatsinha0)
    • #11577 fix(blog): Fix author paginated page url: /blog/authors/<author>/page/2 (@slorber)
    • #11562 chore(blog): refactor blog Content, remove useless blogListPaginated attribute (@slorber)
    • #11559 fix(content-blog): filter unlisted posts from author pages (@pyrytakala)
  • docusaurus-theme-classic, docusaurus-theme-common
  • docusaurus-plugin-ideal-image
    • #11659 fix(ideal-image): <IdealImage> should forward remaining props to the underlying component (@tempoz)
  • eslint-plugin
    • #11587 fix(eslint-plugin): specify exact type of no-untranslated-text rule options (@andreww2012)
  • docusaurus-mdx-loader
    • #11530 fix(mdx-loader): fix url.parse deprecation warning on Node 24+ (@kou029w)
  • docusaurus-bundler, docusaurus-faster, docusaurus-theme-mermaid
    • #11496 fix(faster): fix server build SWC / browserslist node target (@slorber)
:running_woman: Performance
  • docusaurus-plugin-content-blog
    • #11707 refactor(content-blog): decouple getTagsFile from generateBlogPosts (@garry00107)
  • create-docusaurus, docusaurus-utils, docusaurus
    • #11684 refactor(create-docusaurus): remove useless dependencies (docusaurus-utils, execa, fs-extra) + simplify some code (@slorber)
  • create-docusaurus
    • #11653 refactor(create-docusaurus): replace lodash with native implementation (@torresgol10)
:memo: Documentation
  • docusaurus
    • #11779 chore(website): migrate MDX heading ids to comment syntax + upgrade Crowdin parser version (@slorber)
  • Other
    • #11784 docs(website): change recommended syntax for math equations (@slorber)
    • #11623 docs: Add expose-markdown-docusaurus-plugin resource (@FlyNumber)
:robot: Dependencies
:wrench: Maintenance
  • Other
    • #11846 chore(website): disable mdx1Compat.comments on our site (@slorber)
    • #11845 chore(website): Upgrade to Algolia v4.6 (@slorber)
    • #11795 chore(ci): canary/trusted publishing shouldn't use any caching (@slorber)
    • #11753 chore: Add basic AGENTS.md (@slorber)
    • #11639 test(jest): simplify Jest snapshotPathNormalizer.ts (@slorber)
    • #11626 chore(website): upgrade to DocSearch 4.4.0 + fix little website theming issues (@slorber)
    • #11553 chore(ci): upgrade Netlify to Node 24 (LTS) + add git backfill command (@slorber)
  • create-docusaurus, docusaurus-babel, docusaurus-bundler, docusaurus-cssnano-preset, docusaurus-faster, docusaurus-logger, 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-css-cascade-layers, 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-rsdoctor, docusaurus-plugin-sitemap, docusaurus-plugin-svgr, docusaurus-plugin-vercel-analytics, 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-tsconfig, docusaurus-types, docusaurus-utils-common, docusaurus-utils-validation, docusaurus-utils, docusaurus, eslint-plugin, lqip-loader, stylelint-copyright
    • #11823 chore(ci): fixes for the npm trusted publishing workflow (@slorber)
    • #11819 chore(ci): add Trusted Publishing release workflow through dispatch action (@slorber)
  • docusaurus-plugin-content-docs, docusaurus-plugin-ideal-image, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-mermaid, docusaurus-utils, docusaurus
  • docusaurus-cssnano-preset, docusaurus-logger, docusaurus-mdx-loader, docusaurus-plugin-client-redirects, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-ideal-image, docusaurus-remark-plugin-npm2yarn, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-utils-validation, docusaurus-utils, docusaurus
  • docusaurus-theme-classic, docusaurus-theme-common, docusaurus
    • #11697 chore(monorepo): upgrade React monorepo types to v19 (@slorber)
  • docusaurus-babel
  • docusaurus-plugin-content-blog
:globe_with_meridians: Translations
  • docusaurus-theme-translations
Committers: 41
View originalPermalink
How v3.10.0 went
v3.9.2

3.9.2

Changed 2
  • Lazy load the Mermaid library
  • Improve Arabic theme translations
Fixed 8
  • Add support for missing `sidebar_key` front matter attribute in docs plugin
  • Disable CSS counter minification in cssnano preset
  • Fix Algolia AskAI validation logic in theme-search-algolia
  • Add missing Polish (pl) theme translations
  • Fix CSS `scroll-margin-top` when clicking footnote items
  • Allow `i18n.localeConfigs.translate` in validation
  • Fix Mermaid ELK layout dependency required bug on v3.9
  • Remove "Edit this page" button from print view
3.9.2 (2025-10-17)
:bug: Bug Fix
  • docusaurus-plugin-content-docs
    • #11490 fix(docs): add support for missing sidebar_key front matter attribute (@slorber)
  • docusaurus-cssnano-preset
    • #11487 fix(cssnano-preset): disable CSS counter minification (@YDKK)
  • docusaurus-theme-search-algolia
    • #11468 fix(theme-search-algolia): Fix Algolia AskAI validation logic (@slorber)
  • docusaurus-theme-translations
  • docusaurus-theme-classic, docusaurus-theme-common
    • #11466 fix(theme): Fix CSS scroll-margin-top when clicking footnote items, factorize code (@slorber)
  • docusaurus
    • #11452 fix(core): allow i18n.localeConfigs.translate in validation (@trofim24)
  • docusaurus-theme-mermaid
    • #11437 fix(theme-mermaid): Fix Mermaid ELK layout dependency required bug on v3.9 (@slorber)
:running_woman: Performance
  • docusaurus-theme-mermaid
    • #11438 perf(theme-mermaid): lazy load the Mermaid library (@slorber)
:nail_care: Polish
  • docusaurus-theme-classic
    • #11463 fix(theme): remove "Edit this page" button from print view (@richk21)
:robot: Dependencies
:globe_with_meridians: Translations
Committers: 9
View originalPermalink
How v3.9.2 went
v3.9.1

3.9.1

Fixed 1
  • Fix Docusaurus outDir for sites using baseUrl
3.9.1 (2025-09-26)
:bug: Bug Fix
  • docusaurus
    • #11434 fix(core): fix Docusaurus outDir for sites using baseUrl (@slorber)
Committers: 1
View originalPermalink
How v3.9.1 went
v3.9.0

3.9.0

Added 11
  • Use DocSearch v4.1 with optimized integration in theme-search-algolia
  • Add support for email social icon in blog and resize default social icon
  • Add theme-tabs-container stable className to theme
  • Add runtime support for DocSearch v4
  • Resolve @site/* markdown links and fix resolution priority bugs
  • Support elk layout in mermaid theme
Changed 3
  • Upgrade Rspack to 1.5 and use lazyBarrel experiment
  • Upgrade Rspack to 1.4 in faster plugin
  • Use respectPrefersColorScheme in create-docusaurus init template
Fixed 5
  • Fix copy of indented code blocks and replace copy-text-to-clipboard by clipboard API
  • Remove hardcoded fill from Bluesky and LinkedIn icons
  • Render sidebar category index with unlisted children as a simple doc/link item
  • Add translate no to heading anchors and blog authors
  • Doc sidebar links and categories with long labels should display properly
Deprecated 1
  • Deprecate siteConfig.onBrokenMarkdownLinks
3.9.0 (2025-09-25)
:rocket: New Feature
  • docusaurus-theme-search-algolia
    • #11421 feat(theme-search-algolia): use DocSearch v4.1, optimize integration (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-theme-classic
    • #11425 feat(blog): Add support for email social icon + resize default social icon a bit (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-common
    • #11426 feat(theme): Add theme-tabs-container stable className (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-search-algolia, docusaurus-theme-translations
  • docusaurus-faster, docusaurus
    • #11415 feat(faster): upgrade Rspack to 1.5, use lazyBarrel experiment, remove deprecated option (@slorber)
    • #11294 feat(faster): Upgrade to Rspack 1.4 (@slorber)
  • docusaurus-utils
    • #11397 feat(mdx): resolve @site/* markdown links, fix resolution priority bugs (@slorber)
  • docusaurus-theme-mermaid
  • docusaurus-plugin-pwa, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-types, docusaurus-utils, docusaurus
    • #11316 feat(core): Add i18n.localeConfigs[locale].{url,baseUrl} config options, fix multi-domain deployments (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-types, docusaurus-utils, docusaurus
    • #11304 feat(core): add i18n.localeConfigs.translate + skip translation process if i18n/<locale> dir doesn't exist (@slorber)
  • docusaurus-plugin-content-docs
    • #11228 feat(docs): sidebar item key attribute - fix docs translations key conflicts (@slorber)
  • create-docusaurus
    • #11293 feat(create-docusaurus): use respectPrefersColorScheme in init template (@slorber)
  • docusaurus-mdx-loader, docusaurus-types, docusaurus
    • #11282 feat(core): add siteConfig.markdown.emoji config option to disable remark-emoji (@slorber)
  • create-docusaurus, docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-types, docusaurus
    • #11283 feat(core): Add siteConfig.markdown.hooks, deprecate siteConfig.onBrokenMarkdownLinks (@slorber)
:bug: Bug Fix
  • docusaurus-theme-classic, docusaurus
    • #11422 fix(theme): fix copy of indented code blocks, replace copy-text-to-clipboard by clipboard API (@slorber)
  • docusaurus-theme-classic
    • #11407 fix(theme): remove hardcoded fill from Bluesky and LinkedIn icons (@Simek)
    • #11389 fix(theme): render sidebar category index with unlisted children as a simple doc/link item (@slorber)
    • #11360 fix(theme): Add translate no to heading anchors and blog authors (@slorber)
    • #11356 fix(theme): Doc sidebar links/categories with long labels should display properly (@slorber)
    • #11338 fix(theme-classic): fix collapsed sidebar category expansion when navigating to another link within that category (@qqq614)
    • #11289 fix(theme): Fix footnote ref scrolling behind the navbar when footnote back reference clicked (@slorber)
  • docusaurus
    • #11410 fix(deps): upgrade webpack-dev-server to v5, fix security warning (@slorber)
    • #11347 fix(core): Fix docusaurus start on macOS when exec throws a synchronous error (@slorber)
    • #11271 fix(dev-server): use correct dev server HTML lang attribute (@enumura1)
  • docusaurus-theme-common
    • #11405 fix(theme): fix useColorMode() visual glitches due to provider unmounts/remounts (@slorber)
    • #11280 fix(theme-common): Export FooterColumnItem type (@stubinubin)
  • docusaurus-bundler, docusaurus-faster
    • #11383 fix(ssg): HTML minifier should preserve <head> for og:image crawlers (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-translations
    • #11331 fix(theme): Add aria-label to IconExternalLink with value '(opens in new tab)' (@WestonThayer)
  • docusaurus-plugin-content-docs
    • #11281 fix(docs): Fix empty sidebar item category className lost when post-processed to a doc (@slorber)
    • #11251 fix(docs): prevent docs ids conflicts within a version (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-common
    • #11263 fix(theme): make useHistorySelector() hydration-safe + use it read search/hash in theme (@slorber)
:memo: Documentation
:robot: Dependencies
:wrench: Maintenance
  • create-docusaurus, docusaurus-babel, docusaurus-bundler, docusaurus-cssnano-preset, docusaurus-faster, docusaurus-logger, docusaurus-mdx-loader, docusaurus-plugin-client-redirects, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-css-cascade-layers, 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-rsdoctor, docusaurus-plugin-sitemap, docusaurus-plugin-svgr, docusaurus-plugin-vercel-analytics, 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
    • #11408 chore: drop support for Node 18, that reached End-of-Life (@slorber)
  • docusaurus-theme-classic
  • docusaurus-plugin-content-docs
  • docusaurus-bundler
    • #11290 chore: upgrade website to Rspack 1.4 + fix Rspack internal performance tracing (@slorber)
  • Other
    • #11287 chore(website): split changelog per version + adjust changelog plugin implementation (@slorber)
:globe_with_meridians: Translations
  • docusaurus-theme-translations
    • #11315 fix(theme-translations): Add missing Portuguese (pt-BR) theme translations and improve some of it. (@marcelocell)
    • #11305 fix(translations): Add missing Ukrainian translations (@maluke)
Committers: 18
View originalPermalink
How v3.9.0 went
v3.8.1

3.8.1

Changed 1
  • Avoid duplicated git log calls in loadContent() and postBuild() for untracked Git files
Fixed 6
  • Fix inability to navigate to category's page when browsing its children items in theme
  • Fix Windows CSS cascade layers bug
  • Fix docusaurus start using concatenateModules: true
  • Include Arc to supported Chromium browsers
  • Fix docusaurus start error for macOS users with no Chromium-based browser
  • Fix future flags public types
:bug: Bug Fix
  • docusaurus-theme-classic
    • #11242 fix(theme): fix unability to navigate to category's page when browsing its children items (@slorber)
  • docusaurus-plugin-css-cascade-layers
    • #11241 fix(css-cascade-layers): fix windows css cascade layers bug (@slorber)
  • docusaurus
    • #11222 fix(bundler): fix docusaurus start using concatenateModules: true (@slorber)
    • #11217 fix: include Arc to supported Chromium Browsers (@wellwelwel)
    • #11205 fix(core): fix docusaurus start error for macOS users with no Chromium-based browser (@slorber)
  • docusaurus-types
:running_woman: Performance
  • docusaurus-plugin-content-blog, docusaurus-plugin-sitemap, docusaurus-theme-classic, docusaurus-types, docusaurus-utils, docusaurus
    • #11211 perf: avoid duplicated git log calls in loadContent() and postBuild() for untracked Git files (@slorber)
:wrench: Maintenance
  • docusaurus-faster
  • docusaurus-plugin-content-docs
    • #11230 refactor(docs): extract loadVersion() without changing the behavior (@slorber)
  • Other
Committers: 7
View originalPermalink
How v3.8.1 went
v3.8.0

3.8.0

Added 14
  • Add new CSS cascade layers plugin with built-in v4.useCssCascadeLayers future flag
  • Add internal flag to skip bundling in core
  • Enable Rspack parallelCodeSplitting
  • Make it possible to provide your own page title formatter
  • Support frontMatter.slug in pages plugin like docs and blog plugins
  • Add bundler tracing and profiling
Fixed 6
  • Replace reading-time with Intl.Segmenter API in content-blog plugin
  • Fix blog Atom feed item url and XSL bug
  • Remove opt-in for mdx dependency file in mdx-loader
  • Fix versioning CLI to copy localized translation file current.json to version-<v>.json
  • Restore former code block theme-common internal APIs
  • Fix code block magic comments with CRLF line breaks bug
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
  • 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
  • docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
    • #10987 feat(theme): Allow resetting colorMode to System/OS value (@slorber)
  • docusaurus-remark-plugin-npm2yarn
  • 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
  • docusaurus-plugin-content-blog
  • 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
  • docusaurus-theme-translations
  • 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
  • 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
  • docusaurus-logger
: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
  • 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
  • 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
: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
:wrench: Maintenance
  • docusaurus-mdx-loader, docusaurus-utils
    • #11168 chore: add Node 24 to CI + fix deprecation warnings (@slorber)
  • docusaurus-plugin-content-blog
  • docusaurus-mdx-loader, docusaurus-theme-common, docusaurus-theme-live-codeblock
    • #11077 refactor(live-codeblock): refactor live code block theme components (@slorber)
  • Other
  • docusaurus-faster
  • docusaurus-theme-mermaid
  • docusaurus-mdx-loader
  • 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
  • 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
  • docusaurus-cssnano-preset, docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-remark-plugin-npm2yarn, eslint-plugin, stylelint-copyright
  • 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
  • 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
View originalPermalink
How v3.8.0 went
v3.7.0

3.7.0

Added 5
  • Turn Rspack incremental on by default
  • Add author social icons for bluesky, mastodon, threads, twitch, youtube, and instagram in blog posts
  • Add React 19 support to Docusaurus v3
  • Add frontMatter.sidebar_label option for blog posts
  • Create new Docusaurus SVGR plugin
Changed 2
  • Use Intl native API to get locale direction and remove rtl-detect dependency
  • Upgrade algoliasearch to v5
Fixed 9
  • Add missing npm-to-yarn converter for Bun
  • Footer Column/Link should merge provided className
  • Fix React hydration errors and change html minifier settings
  • Code block magic comments should support SQL block comments
  • Add missing Dutch (nl) theme translations
  • Add missing Korean (ko) theme translations
3.7.0 (2025-01-03)
:rocket: New Feature
  • docusaurus-faster, docusaurus
    • #10800 feat(core): Turn Rspack incremental on by default (again) (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-theme-classic
    • #10768 feat(blog): Add author social icons for bluesky, mastodon, threads, twitch, youtube, instagram (@GingerGeek)
  • 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-rsdoctor, docusaurus-plugin-sitemap, docusaurus-plugin-svgr, docusaurus-plugin-vercel-analytics, docusaurus-preset-classic, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-live-codeblock, docusaurus-theme-mermaid, docusaurus-theme-search-algolia, docusaurus-types, docusaurus
  • docusaurus-plugin-content-blog
  • docusaurus-module-type-aliases, docusaurus-plugin-svgr, docusaurus-preset-classic, docusaurus-types, docusaurus-utils, docusaurus
:bug: Bug Fix
  • docusaurus-remark-plugin-npm2yarn
    • #10803 fix(npm-to-yarn): add missing npm-to-yarn converter for Bun (@Lehoczky)
  • docusaurus-theme-classic, docusaurus-theme-common
    • #10796 fix(theme): Footer Column/Link should merge provided className (@slorber)
  • docusaurus-bundler, docusaurus-theme-common
    • #10786 fix(core): fix React hydration errors, change html minifier settings (@slorber)
  • docusaurus-theme-common
    • #10782 fix(theme-common): code block magic comments should support SQL block comments (@WillBlack403)
  • docusaurus-theme-translations
    • #10783 fix(theme-translations): Add missing Dutch (nl) theme translations (@janaukema)
    • #10760 fix(theme-translation): add missing Korean (ko) theme translations (@effozen)
  • docusaurus-plugin-content-docs
    • #10754 fix(docs): fix sidebar item visibility bug for category index (@slorber)
  • docusaurus
    • #10727 fix(core): fix codegen routesChunkName possible hash collision (@slorber)
  • docusaurus-mdx-loader
    • #10723 fix(mdx-loader): fix md image paths with spaces bug related to transformImage encoding problem (@slorber)
:memo: Documentation
:robot: Dependencies
:wrench: Maintenance
  • Other
  • docusaurus-theme-search-algolia
  • docusaurus
    • #10798 refactor(core): Use Intl native API to get locale direction, remove rtl-detect depend… (@slorber)
    • #10747 refactor(core): swizzle wrap should use ReactNode instead of JSX.Element (@slorber)
  • create-docusaurus, docusaurus-mdx-loader, docusaurus-module-type-aliases, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-debug, 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-types, docusaurus
  • docusaurus-theme-common
    • #10728 refactor(theme-common): change storageUtils useSyncExternalCode getSnapshot workaround (@slorber)
Committers: 14
View originalPermalink
How v3.7.0 went
v3.6.3

3.6.3

Fixed 1
  • Disable Rspack incremental in dev mode to resolve development build issues
3.6.3 (2024-11-22)
:bug: Bug Fix
  • docusaurus
View originalPermalink
How v3.6.3 went
View all

Discussion