Upgrading Docusaurus
Docusaurus versioning is based on the major.minor.patch scheme and respects Semantic Versioning.
Breaking changes are only released on major version upgrades, and thoroughly documented in the following upgrade guides.
Troubleshooting upgrades
Section titled βTroubleshooting upgradesβWhen upgrading Docusaurus you may experience issues caused by mismatching cached dependencies - there are a few troubleshooting steps you should perform to resolve these common issues before reporting a bug or seeking support.
Run the clear command
Section titled βRun the clear commandβThis CLI command is used to clear a Docusaurus site's generated assets, caches and build artifacts.
npm run clearRemove node_modules and your lock file(s)
Section titled βRemove node_modules and your lock file(s)βRemove the node_modules folder and your package manager's lock file using the following:
rm -rf node_modules yarn.lock package-lock.json@('node_modules','yarn.lock','package-lock.json') | Remove-Item -Force -Recurse -ErrorAction SilentlyContinueThen reinstall packages and regenerate the lock file using:
npm install