2.0.0-beta.16

🚀 New Feature​

• docusaurus-logger, docusaurus-module-type-aliases, docusaurus-plugin-debug, docusaurus-plugin-pwa, docusaurus-theme-classic, docusaurus-theme-search-algolia, docusaurus-types, docusaurus
  • #6243 feat(core): brand new swizzle CLI experience (@Josh-Cena)
• create-docusaurus
  • #6750 feat(create): new --package-manager option; interactive package manager selection (@Josh-Cena)
  • #6610 feat(create): allow specifying a git clone strategy (@Josh-Cena)
• docusaurus-theme-classic, docusaurus-theme-common
  • #6723 feat: sync color mode between browser tabs (@lex111)
• docusaurus-theme-search-algolia
  • #6692 feat(search-algolia): allow disabling search page and configuring path (@lex111)
• docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common
  • #6517 feat(docs,theme-classic): docs breadcrumbs (@jodyheavener)
  • #6519 feat(content-docs): sidebar item type "html" for rendering pure markup (@jodyheavener)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-utils
  • #6593 feat(content-blog): infer blog post date from git history (@felipecrs)
• docusaurus-plugin-content-docs
  • #6619 feat(content-docs): add custom props front matter (@TheCatLady)
  • #6452 feat(content-docs): allow explicitly disabling index page for generated category (@Josh-Cena)
• docusaurus-plugin-content-blog
  • #6603 feat(content-blog): allow customizing blog archive component through option (@Josh-Cena)
• docusaurus-plugin-content-blog, docusaurus-theme-classic
  • #6221 feat(content-blog): Allow pagination for BlogTagsPostsPage (@redhoyasa)

💥 Breaking Change​

• create-docusaurus, 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-ideal-image, docusaurus-plugin-pwa, docusaurus-plugin-sitemap, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-live-codeblock, docusaurus-theme-search-algolia, docusaurus-theme-translations, docusaurus-utils, docusaurus, stylelint-copyright
  • #6752 chore: upgrade docsearch-react to v3 stable, bump dependencies (@Josh-Cena)
• docusaurus-mdx-loader, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-types
  • #6729 refactor: make MDX export a flat TOC list instead of tree (@Josh-Cena)
• docusaurus-types, docusaurus-utils-validation, docusaurus
  • #6740 refactor: remove deprecated Webpack utils & validation escape hatch (@Josh-Cena)
• docusaurus-theme-classic, docusaurus-theme-search-algolia
  • #6707 refactor(theme-classic): bias again search metadata toward Algolia DocSearch (@slorber)
• docusaurus-module-type-aliases, docusaurus-theme-common, docusaurus
  • #6651 refactor: reduce exported members of docusaurus router (@Josh-Cena)

🐛 Bug Fix​

• docusaurus-theme-common
  • #6758 fix(theme-common): isSamePath should be case-insensitive (@slorber)
  • #6748 fix(theme-classic): temporarily disable toc heading autoscrolling (@slorber)
  • #6696 fix(theme-common): do not run useLocationChange when hot reloading (@lex111)
  • #6490 fix(theme-classic): do not switch color modes when printing (@Josh-Cena)
• docusaurus-module-type-aliases, docusaurus-theme-classic, docusaurus-theme-common
  • #6749 fix(theme-classic): fix breadcrumb home link bug with new useHomePageRoute() hook (@slorber)
• docusaurus-plugin-content-docs
  • #6720 fix(content-docs): create assets for frontmatter images (@lebalz)
  • #6592 fix(content-docs): read last update from inner git repositories (@felipecrs)
  • #6477 fix(content-docs): export versioning utils (@milesj)
• docusaurus-mdx-loader
  • #6712 fix(mdx-loader): make headings containing links properly formatted in ToC (@Josh-Cena)
• docusaurus
  • #6701 fix(cli): disable directory listing in serve (@Josh-Cena)
  • #6607 fix(cli): log error itself on unhandled rejection (@Josh-Cena)
  • #6500 fix(cli): allow passing a list of file names to write-heading-ids (@Josh-Cena)
  • #6496 fix(core): configValidation should allow inline theme functions (@slorber)
• docusaurus-theme-classic
  • #6652 fix(theme-classic): minor BTT button fixes (@lex111)
  • #6612 fix(theme-classic): make Prism additional languages properly server-side rendered (@Josh-Cena)
  • #6599 fix(theme-classic): add docSidebar as allowed item in dropdown (@homotechsual)
  • #6531 fix(theme-classic): highlight active collapsible doc category properly (@lex111)
  • #6515 fix(theme-classic): add key prop for SimpleLinks map (@kgajera)
  • #6508 fix(theme-classic): apply width/height for footer logos without href (@kgajera)
• docusaurus-utils
  • #6617 fix(utils): convert Markdown links in reference-style links with multiple spaces (@Josh-Cena)
  • #6489 fix(utils): do not resolve Markdown paths with @site prefix (@Josh-Cena)
  • #6478 fix(utils): Markdown linkification match local paths beginning with http (@Josh-Cena)
• docusaurus-plugin-content-docs, docusaurus-theme-classic
  • #6495 fix(content-docs): render category with no subitems as a normal link (@Josh-Cena)

💅 Polish​

• docusaurus-mdx-loader, docusaurus-migrate, docusaurus-plugin-client-redirects, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus-utils, docusaurus, lqip-loader
  • #6755 refactor: unify error handling behavior (@Josh-Cena)
• create-docusaurus
  • #6679 feat(create): better detection of package manager preference (@lex111)
  • #6481 refactor(init): promote good practices; use site alias (@Josh-Cena)
• docusaurus-plugin-content-docs
  • #6745 fix(content-docs): improve sidebar shorthand normalization error message (@Josh-Cena)
  • #6602 feat(content-docs): allow omitting enclosing array consistently for category shorthand (@Josh-Cena)
  • #6596 refactor(content-docs): clean up sidebars logic; validate generator returns (@Josh-Cena)
  • #6586 refactor(content-docs): read category metadata files before autogenerating (@Josh-Cena)
• docusaurus-module-type-aliases, docusaurus-plugin-ideal-image, docusaurus-plugin-pwa, docusaurus-theme-classic, docusaurus
  • #6730 refactor: declare all props as interfaces (@Josh-Cena)
• docusaurus-theme-translations
  • #6711 chore(theme-translations): complete Korean translations (@revi)
  • #6686 fix(theme-translations): improve Korean translations (@winterlood)
  • #6635 refactor(theme-translation): improve Traditional Chinese translation quality (@toto6038)
• docusaurus-theme-classic, docusaurus-theme-translations
  • #6674 fix(theme-classic): improve aria label of color mode toggle (@Josh-Cena)
• create-docusaurus, docusaurus-theme-classic
  • #6668 refactor: recommend using data-theme without html element selector (@Josh-Cena)
• docusaurus-theme-classic
  • #6622 refactor(theme-classic): clean up CSS of doc sidebar item (@lex111)
• docusaurus
  • #6644 fix(core): forward ref to Link's anchor element (@koistya)
  • #6646 fix(cli): make docusaurus clear also remove .yarn/.cache folder (@Josh-Cena)
  • #6306 feat(core): use react-helmet-async (@seyoon20087)
• docusaurus-utils-validation
  • #6656 feat: allow numbers in plugin ID (@cdemonchy-pro)
• docusaurus-mdx-loader, docusaurus-utils, lqip-loader
  • #6650 refactor(utils): replace hash with contenthash for file loader (@Josh-Cena)
• create-docusaurus, docusaurus-mdx-loader, 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-ideal-image, docusaurus-plugin-pwa, docusaurus-plugin-sitemap, docusaurus-preset-classic, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus-utils-validation, docusaurus-utils
  • #6615 fix: remove more peer dependency warnings (@Josh-Cena)
• docusaurus-mdx-loader
  • #6598 feat: make Markdown images lazy loaded (@johnnyreilly)
• docusaurus-theme-classic, docusaurus-theme-common
  • #6505 fix(theme-classic): make focused link outlined with JS disabled (@Josh-Cena)
• docusaurus-plugin-content-docs, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus-types, docusaurus-utils, docusaurus
  • #6507 refactor: improve internal typing (@Josh-Cena)
• docusaurus-mdx-loader, 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-sitemap, docusaurus-preset-classic, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus-utils-validation, docusaurus-utils
  • #6498 fix: updating peerDependency fields for yarn berry (@vidarc)
• docusaurus-theme-classic, docusaurus-theme-search-algolia, docusaurus-theme-translations
  • #6482 feat: mark some text labels as translatable (@Josh-Cena)

📝 Documentation​

• Other
  • #6727 docs: add Blog Matheus Brunelli site to showcase (@mrbrunelli)
  • #6721 docs: add Butterfly Documentation to showcase (@CodeDoctorDE)
  • #6710 docs(website): Add techharvesting to showcase (@NaseelNiyas)
  • #6708 docs: add doc for generated-index keyword/image metadata (@slorber)
  • #6709 docs(website): fix video responsiveness (@lex111)
  • #6687 docs: add deep dive video for Docusaurus (@dmitryvinn)
  • #6704 docs(website): search doc typo searchParameters (@slorber)
  • #6682 docs: add redux-cool site to showcase (@Ruben-Arushanyan)
  • #6677 docs: add Rivalis to showcase (@kalevski)
  • #6676 docs: add SmartCookieWeb site to showcase (@CookieJarApps)
  • #6675 docs: mention that all official themes are TypeScript-covered (@Josh-Cena)
  • #6673 docs: mention about blog date in front matter (@Josh-Cena)
  • #6672 refactor(website): extract homepage data from UI; feature text updates (@Josh-Cena)
  • #6670 docs: add CyberDrain Improved Partner Portal (CIPP) to showcase (@homotechsual)
  • #6667 fix(website): make YT iframe responsive (@lex111)
  • #6659 docs: add eli5 video to home page (@dmitryvinn-fb)
  • #6633 docs: improve wording of using Markdown file paths (@BigDataWriter)
  • #6624 docs: add Resoto & Some Engineering Inc. to showcase (@TheCatLady)
  • #6611 docs: fix bad anchor link syntax (@Josh-Cena)
  • #6591 docs: improve GitHub Actions example jobs (@ebarojas)
  • #6426 feat(website): add Tweets section (@yangshun)
  • #6532 docs: add SAP Cloud SDK to showcase (@artemkovalyov)
  • #6513 docs: clean up CONTRIBUTING (@Josh-Cena)
  • #6501 docs: add Cloudflare pages deployment guide (@apidev234)
  • #6499 docs: mention how env vars can be read (@Josh-Cena)
  • #6492 docs: mention where to find the sitemap (@tamalweb)
  • #6491 docs: add developers.verida to showcase (@nick-verida)
  • #6414 feat(website): new plugin to load CHANGELOG and render as blog (@Josh-Cena)
  • #6404 docs: elaborate on Markdown asset linking; document pathname:// protocol (@Josh-Cena)
  • #6484 docs: remove mention that CDN resources are cached cross-domain (@Josh-Cena)
  • #6429 refactor: self-host KaTeX assets (@pranabdas)
  • #6483 docs: mark a lot of website texts as translatable (@Josh-Cena)
• docusaurus-preset-classic
  • #6627 docs: fix presets documentation link (@thedanielhanke)

🏠 Internal​

• docusaurus-theme-classic
  • #6759 refactor(theme-classic): merge CSS files for Heading (@slorber)
  • #6584 misc: enable jsx-key eslint rule (@Josh-Cena)
• docusaurus-migrate
  • #6756 test: sort migration test FS mock calls (@Josh-Cena)
  • #6609 refactor(migrate): change internal methods' parameter style (@Josh-Cena)
  • #6476 chore: fix Stylelint globs for editor support (@nschonni)
• docusaurus-plugin-content-docs, docusaurus-theme-classic
  • #6744 fix(content-docs): properly display collocated social card image (@Josh-Cena)
• docusaurus-module-type-aliases, docusaurus-types, docusaurus
  • #6742 refactor: improve client modules types (@Josh-Cena)
• docusaurus-module-type-aliases
  • #6741 chore(module-type-aliases): add react as peer dependency (@Josh-Cena)
  • #6658 refactor(module-aliases): remove react-helmet dependency (@Josh-Cena)
• Other
  • #6726 misc: improve bug report template (@Josh-Cena)
  • #6512 misc: configure linguist behavior to show better language stats (@Josh-Cena)
  • #6487 chore: fix codesandbox example link + mention npm publish recovery (@slorber)
  • #6486 chore: update examples for beta.15 (@slorber)
  • #6485 fix(website): bad translate tags without default translation (@slorber)
• docusaurus-plugin-client-redirects, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus-theme-translations, docusaurus-utils, docusaurus, lqip-loader
  • #6716 refactor: ensure lodash is default-imported (@Josh-Cena)
• create-docusaurus, docusaurus-logger, docusaurus-migrate, docusaurus
  • #6661 refactor: convert CLI entry points to ESM; migrate create-docusaurus to ESM (@Josh-Cena)
• docusaurus-module-type-aliases, docusaurus-theme-common, docusaurus
  • #6651 refactor: reduce exported members of docusaurus router (@Josh-Cena)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-classic
  • #6629 refactor: move module declarations for non-route components to theme-classic (@Josh-Cena)
• docusaurus-plugin-pwa, docusaurus-theme-classic
  • #6614 refactor: remove Babel plugins that are included in preset-env (@Josh-Cena)
• docusaurus-module-type-aliases, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-live-codeblock, docusaurus-theme-translations, docusaurus-utils-validation, docusaurus-utils, docusaurus
  • #6605 chore: fix ESLint warnings, restrict export all syntax (@Josh-Cena)
• docusaurus-theme-live-codeblock, docusaurus-theme-search-algolia
  • #6583 refactor(live-codeblock): migrate theme to TS (@Josh-Cena)
• docusaurus-migrate, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-ideal-image, docusaurus-plugin-pwa, docusaurus-theme-common, docusaurus-utils, docusaurus, lqip-loader
  • #6524 refactor: enforce named capture groups; clean up regexes (@Josh-Cena)
• docusaurus-migrate, docusaurus-plugin-content-docs, docusaurus
  • #6521 refactor: mark all functions that import external modules as async (@Josh-Cena)
• create-docusaurus, docusaurus-cssnano-preset, docusaurus-logger, docusaurus-mdx-loader, docusaurus-migrate, 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-ideal-image, docusaurus-plugin-pwa, docusaurus-remark-plugin-npm2yarn, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus-theme-translations, docusaurus-types, docusaurus-utils-common, docusaurus-utils-validation, docusaurus-utils, docusaurus, stylelint-copyright
  • #6514 chore: clean up ESLint config, enable a few rules (@Josh-Cena)
• docusaurus-types, docusaurus
  • #6511 refactor(core): convert theme-fallback to TS (@Josh-Cena)
• create-docusaurus, docusaurus-utils
  • #6506 test: add test for readOutputHTMLFile (@Josh-Cena)
• docusaurus-migrate, docusaurus-theme-common
  • #6502 refactor: fix all eslint warnings (@Josh-Cena)
• docusaurus-mdx-loader, docusaurus-remark-plugin-npm2yarn, docusaurus
  • #6474 test: rename 'fixtures' to 'fixtures' (@nschonni)

:running: Performance​

• create-docusaurus, docusaurus-mdx-loader, docusaurus-migrate, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-search-algolia, docusaurus-theme-translations, docusaurus-utils, docusaurus
  • #6725 refactor: convert all fs methods to async (@Josh-Cena)

Committers: 38​

• Alexey Pyltsyn (@lex111)
• Artem Kovalov (@artemkovalyov)
• Balthasar Hofer (@lebalz)
• Clement Demonchy (@cdemonchy-pro)
• CodeDoctor (@CodeDoctorDE)
• Daniel Hanke (@thedanielhanke)
• Daniel Kalevski (@kalevski)
• Dmitry Vinnik (@dmitryvinn)
• Dmitry Vinnik | Meta (@dmitryvinn-fb)
• Erick Zhao (@erickzhao)
• Everardo J. Barojas M. (@ebarojas)
• Felipe Santos (@felipecrs)
• Gaurish (@apidev234)
• Hong Yongmin (@revi)
• Jody Heavener (@jodyheavener)
• John Reilly (@johnnyreilly)
• Joshua Chen (@Josh-Cena)
• Kishan Gajera (@kgajera)
• Konstantin Tarkus (@koistya)
• Matheus Ricardo Brunelli (@mrbrunelli)
• Matthew Ailes (@vidarc)
• Mikey O'Toole (@homotechsual)
• Miles Johnson (@milesj)
• Muhammad Redho Ayassa (@redhoyasa)
• Naseel Niyas (@NaseelNiyas)
• Nick Schonning (@nschonni)
• Pranab Das (@pranabdas)
• Ruben Arushanyan (@Ruben-Arushanyan)
• Sébastien Lorber (@slorber)
• Tamal Web (@tamalweb)
• Yangshun Tay (@yangshun)
• @BigDataWriter
• @CookieJarApps
• @TheCatLady
• @nick-verida
• @seyoon20087
• @toto6038
• 이정환 (@winterlood)