TL;DR

Docusaurus now resolves a webpack bundling issue that could have broken site builds after a recent webpack update.

Fixes Worth Knowing

A bug in the Docusaurus bundler (tool for packaging website files) has been fixed, preventing build failures caused by changes in the underlying webpack toolchain.

TL;DR

Docusaurus 3.0 is here, bringing TypeScript and ESM support, React 18, and MDX v3. This is a major upgrade with breaking changes, so review the upgrade guide.

Breaking

• Node Version: Requires Node 18.
• TypeScript/ESM: Migrates to TypeScript and ESM configuration.
• MDX: Upgrades to MDX v3.
• Dependencies: Updates prism-react-renderer to v2 and react-live to v4.
• Docs Plugin: Removes legacy versioned prefixes in docs plugin.
• Admonitions: Changes warning to a first-class admonition, deprecating caution.
• Removed Feature: Removes the docusaurus-migrate plugin.

New

• TypeScript & ESM: Adds first-class TypeScript and ESM configuration support.
• React 18: Upgrades to React 18 with automatic JSX runtime and a --dev build option.
• Mermaid: Upgrades Mermaid to v10.4 with async rendering support.

Fixes Worth Knowing

• Numerous bug fixes across core, MDX loader, and themes, addressing issues with error handling, image rendering, accessibility, and more.
• Improved performance with React 18 startTransition and script loading optimizations.

Before You Upgrade

• Review the upgrade guide: https://docusaurus.io/docs/next/migration/v3
• Update Node: Ensure you are using Node.js version 18 or higher.

TL;DR

Docusaurus now adds description and keywords (metadata) to blog posts, improving SEO.

Fixes Worth Knowing

• Blog posts now render correctly even with JavaScript disabled.
• Canonical URLs (website address) are now consistent regardless of trailing slashes.
• Sidebar generation for documentation now correctly passes custom properties.
• Fixed an issue where unnecessary class names were added to unordered lists.

TL;DR

Docusaurus has undergone significant internal refactoring and feature additions, most notably expanding internationalization (i18n) support with new translations and customization options, and adding more flexibility to theme components.

Breaking

• Theme icons are now located in a subfolder: @theme/Icon/*.
• BlogPostItem component has been split into smaller theme subcomponents.
• Theme packages now separate public and internal APIs.
• DocItem component and useDoc hook have been split in the docs and theme.
• Error reporting level has been removed; reportMessage moved to logger.
• Admonitions are now handled via JSX components.

New

• New Dutch, Swedish, and other translations have been added.
• Algolia search modal can now be translated.
• Customizable logos are now supported in the theme.

Fixes Worth Knowing

• Fixed issues with blog post edit links and code block wrapping.
• Resolved problems with sidebar translation and markdown heading IDs.
• Corrected issues with theme component rendering and metadata usage.

Before You Upgrade

• Update your theme icon imports to reflect the new @theme/Icon/* structure.
• Review your theme component usage as BlogPostItem, DocItem, and other components may have changed.

TL;DR

This release updates underlying dependencies, ensuring continued compatibility with the React ecosystem.

Before You Upgrade

No action is needed for this release. It’s a dependency update and doesn’t require changes to your Docusaurus project.