Skip to content

Upgrade to Docusaurus v3.8.1 + enable Docusaurus Faster - #8

Closed
slorber wants to merge 2 commits into
micro-os-plus:xpackfrom
slorber:slorber/upgrade-docusaurus-3.8.1-faster
Closed

Upgrade to Docusaurus v3.8.1 + enable Docusaurus Faster#8
slorber wants to merge 2 commits into
micro-os-plus:xpackfrom
slorber:slorber/upgrade-docusaurus-3.8.1-faster

Conversation

@slorber

@slorber slorber commented Jun 6, 2025

Copy link
Copy Markdown

Fix facebook/docusaurus#11246

Site can build in less than 2s now (previously 14s)

},

plugins: [
['@docusaurus/plugin-svgr',{}],

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unfortunately this is needed in your case since you don't use the plugin 😅

facebook/docusaurus#10677

I thought it wouldn't affect anyone, but apparently I'm wrong. By chance it's easy to fix and restore the former behavior.

Comment thread website/package.json
"@docusaurus/preset-classic": "3.8.1",
"@docusaurus/theme-search-algolia": "3.8.1",
"@mdx-js/react": "^3.1.0",
"clean-css": "~5.3.3",

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This deps shouldn't be needed, it's used internally and you don't use it when Docusaurus Faster is enabled. We'll remove it later because it's not maintained.

@ilg-ul

ilg-ul commented Jun 6, 2025

Copy link
Copy Markdown
Contributor

Things are a bit more complicated, the configuration files are generated from a template used for all +30 projects.

I updated the template, applied it to this project and the build passed, including the automated build on GitHub Actions.

The total build time came down from +2min to +1min.

I would say that things are pretty fine now.

Thank you for your support!

@ilg-ul ilg-ul closed this Jun 6, 2025
@ilg-ul

ilg-ul commented Jun 6, 2025

Copy link
Copy Markdown
Contributor

Unfortunately enabling faster also enabled the new CSS logic, which broke my site. :-(

I tried to find out how to enable only faster and keep everything else compatible with the old configuration, but the documentation is confusing for me. :-(

I commented out the future configuration; the site rendered more slowly, but correctly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3.7.0 fails to build with svg images?

2 participants