Speed up Docusaurus build

[Miggets7]

Summary

• Rspack + SWC: Replace webpack/Babel with Rspack bundler and SWC via @docusaurus/faster — includes MDX cross-compiler cache, Lightning CSS, multi-threaded SSG, and persistent build cache
• Dev-time version limiting: Only build "current" version during local development (yarn start), so the dev server starts in seconds instead of minutes
• CI improvements: Add Docusaurus build cache step and upgrade Node from 20 to 24
• Image compression: Compress ~470 PNG images with pngquant (65-80% quality), reducing repository size and speeding up checkout/deploy
• Remove babel.config.js: No longer needed with SWC

All 18 versions and all API language tabs remain in production builds.

Test plan

• yarn start — dev server starts quickly with only "current" version
• yarn build — full production build succeeds with all 18 versions
• REST API docs render correctly (code samples, schemas, try-it-out)
• Version dropdown works in production build
• Compressed images display correctly
• CI build passes; verify cache is hit on second run
• If Rspack issues arise with OpenAPI plugin, individual experimental_faster flags can be toggled off

[Copilot]

Pull request overview

Improve Docusaurus build performance by enabling the @docusaurus/faster toolchain, limiting dev-time version builds, and optimizing CI with caching and a newer Node runtime.

Changes:

• Enable @docusaurus/faster / Rspack + SWC via future.experimental_faster flags
• In dev, build only the current docs version to speed up yarn start
• Update CI to use Node 24, add swap space, and cache Docusaurus build artifacts

Reviewed changes

Copilot reviewed 4 out of 473 changed files in this pull request and generated 3 comments.

File	Description
package.json	Adds @docusaurus/faster dependency to support faster build toolchain
docusaurus.config.ts	Enables faster toolchain flags and limits versions in development builds
babel.config.js	Removes Babel config no longer needed with SWC
.github/workflows/ci_cd.yml	Adds swap, updates Node version, and introduces build caching

Comments suppressed due to low confidence (1)

package.json:23

• The new dependency uses a caret range (^3.9.2) while other Docusaurus packages in this file appear to be pinned more tightly (e.g., @docusaurus/theme-mermaid: 3.9.2). To reduce the risk of version skew between tightly-coupled Docusaurus packages, consider pinning @docusaurus/faster to the same exact version.

    "@docusaurus/faster": "^3.9.2",

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

This object spread pattern can fail TypeScript type-checking with errors like 'Spread types may only be created from object types' because the expression is false | { ... }. Prefer a ternary that always returns an object (e.g., condition ? { ... } : {}) to keep the config TS-safe.

Suggested change

	...(process.env.NODE_ENV === 'development' && {
	onlyIncludeVersions: ['current'],
	}),
	...(process.env.NODE_ENV === 'development'
	? { onlyIncludeVersions: ['current'] }
	: {}),

[Copilot]

Allocating a fixed 14G swapfile can fail on ubuntu-latest if there isn’t enough free disk after checkout and dependency install (leading to workflow failures). Consider sizing swap dynamically based on available disk space, or using a smaller/default swap increase to reduce the chance of fallocate failing.

Suggested change

	# Resize existing swap from default 4 GB to 14 GB
	sudo swapoff /swapfile || true
	sudo rm -f /swapfile
	sudo fallocate -l 14G /swapfile
	sudo chmod 600 /swapfile
	sudo mkswap /swapfile
	sudo swapon /swapfile
	# Resize existing swap from default 4 GB to up to 14 GB, depending on free disk space
	sudo swapoff /swapfile || true
	sudo rm -f /swapfile
	# Determine available disk space (in MiB) on the root filesystem
	AVAIL_MB=$(df -m / | awk 'NR==2 {print $4}')
	# Leave 2 GiB free to avoid filling the disk
	TARGET_MB=$((AVAIL_MB - 2048))
	# Cap swap size at 14 GiB (14336 MiB)
	MAX_SWAP_MB=14336
	if [ "$TARGET_MB" -gt "$MAX_SWAP_MB" ]; then
	TARGET_MB=$MAX_SWAP_MB
	fi
	# Ensure a reasonable minimum of 4 GiB (4096 MiB)
	MIN_SWAP_MB=4096
	if [ "$TARGET_MB" -lt "$MIN_SWAP_MB" ]; then
	echo "Not enough free disk space to safely allocate ${MIN_SWAP_MB} MiB swap; skipping swap resize."
	else
	echo "Allocating ${TARGET_MB} MiB of swap space..."
	sudo fallocate -l "${TARGET_MB}M" /swapfile
	sudo chmod 600 /swapfile
	sudo mkswap /swapfile
	sudo swapon /swapfile
	fi

[Copilot]

The cache key doesn’t include the Node version. If the Node version changes (or differs across runners), restoring .docusaurus / node_modules/.cache across Node versions can cause flaky builds or hard-to-debug bundler cache issues. Consider incorporating node-version (and potentially Docusaurus version) into the cache key.