Nicolò Boschi 35ab0b8162 perf(docs): switch the Docusaurus build to Rspack + SWC (#3357) ...

The build-docs CI job had crept from ~95s (January) to ~290s, essentially
all of it webpack: the Server bundle took 1.82m and the Client 2.72m on a
4-vCPU runner, with Babel transpiling ~385 routes and no cache surviving
between runs.

Enable Docusaurus Faster, opting in one flag at a time. The blanket
`experimental_faster: true` preset does not work on this site — both the
SWC JS minifier and the SSG worker threads crash rendering /api-reference
with "ReferenceError: Prism is not defined", because Redoc expects a
`Prism` global neither provides. Leaving those two off and taking the
Rspack bundler, SWC loader, LightningCSS and the MDX cross-compiler cache
keeps the build green.

Measured cold builds (14-core machine, cache cleared each time):

  webpack + Babel + Terser (before)  171s
  SWC loader + LightningCSS only     132s
  Rspack + SWC loader + Terser        56s

Output is unchanged: both bundlers emit the same 871 HTML pages, the same
330M build directory and a byte-identical search index.

No CI cache step accompanies this — Rspack's persistent cache only buys
another ~13s (43s vs 56s) and is not worth a 672MB entry against the
repository's cache budget.

2026-08-10 17:52:51 +02:00

1.7 KiB

Raw Permalink Blame History

View Raw