create-docusaurus

create-docusaurus

Create Docusaurus apps easily with simplified commands:

npm init docusaurus

yarn create docusaurus

npx create-docusaurus@latest

Usage

Please see the installation documentation.

For maintainers

For Docusaurus maintainers, templates can be tested with:

cd `git rev-parse --show-toplevel` # Back to repo root
rm -rf test-website
yarn create-docusaurus test-website classic --javascript
cd test-website
yarn start

Note: test-website is not part of the workspace and use packages from npm.

Use the following to test the templates against local packages:

cd `git rev-parse --show-toplevel` # Back to repo root
rm -rf test-website-in-workspace
yarn create-docusaurus test-website-in-workspace classic --javascript
cd test-website-in-workspace
yarn build
yarn start

For the TypeScript template:

cd `git rev-parse --show-toplevel` # Back to repo root
rm -rf test-website-in-workspace
yarn create-docusaurus test-website-in-workspace classic --typescript
cd test-website-in-workspace
yarn typecheck
yarn build
yarn start

Changelog

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
  • #11431 fix(theme-translation): add missing Polish (pl) theme translations (@mariuszkrzaczkowski)
• 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

• #11479 chore(deps): bump stefanzweifel/git-auto-commit-action from 6 to 7 (@dependabot[bot])
• #11480 chore(deps): bump github/codeql-action from 3.26.5 to 4.30.8 (@dependabot[bot])
• #11481 chore(deps): bump actions/dependency-review-action from 4.8.0 to 4.8.1 (@dependabot[bot])
• #11446 chore(deps): bump actions/dependency-review-action from 4.7.3 to 4.8.0 (@dependabot[bot])

:globe_with_meridians: Translations

• docusaurus-theme-translations
  • #11484 fix(translations): improve Arabic theme translations (@maysara-elshewehy)

Committers: 9

• Alexander Trofimov (@trofim24)
• Dan Roscigno (@DanRoscigno)
• Eleni Grosdouli (@egrosdou01)
• Ethan (@ethanppl)
• Mariusz Krzaczkowski (@mariuszkrzaczkowski)
• Maysara (@maysara-elshewehy)
• Richa Kiran (@richk21)
• Sébastien Lorber (@slorber)
• @YDKK