Speed up Docusaurus build

.github/workflows/ci_cd.yml

@@ -15,27 +15,48 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  # Hosted GitHub runners have 7 GB of memory available, let's use 6 GB
+  # Hosted GitHub runners have 7 GB of memory available, swap handles brief peaks above this
   NODE_OPTIONS: --max-old-space-size=6144
 
 jobs:
   build:
     name: Build
     runs-on: ubuntu-latest
     steps:
+      - name: Add swap space
+        run: |
+          # 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
+          free -h
+
       - name: Checkout
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
 
       - name: Setup Node
         uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
-          node-version: '20'
+          node-version: '24'
           cache: 'yarn'
           cache-dependency-path: yarn.lock
 
       - name: Install dependencies
         run: yarn install --immutable
 
+      - name: Cache Docusaurus build
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4
+        with:
+          path: |
+            .docusaurus
+            node_modules/.cache
+          key: docusaurus-${{ runner.os }}-${{ hashFiles('yarn.lock', 'docusaurus.config.ts', 'versions.json') }}
+          restore-keys: |
+            docusaurus-${{ runner.os }}-
+
       - name: Build
         run: yarn build
 

docusaurus.config.ts

@@ -29,6 +29,23 @@ const config: Config = {
     locales: ['en'],
   },
 
+  future: {
+    v4: {
+      removeLegacyPostBuildHeadAttribute: true,
+      useCssCascadeLayers: true,
+    },
+    experimental_faster: {
+      swcJsLoader: true,
+      swcJsMinimizer: true,
+      swcHtmlMinimizer: true,
+      lightningCssMinimizer: true,
+      rspackBundler: true,
+      rspackPersistentCache: true,
+      mdxCrossCompilerCache: true,
+      ssgWorkerThreads: true,
+    },
+  },
+
   presets: [
     [
       'classic',
@@ -38,6 +55,9 @@ const config: Config = {
           editCurrentVersion: true,
           editUrl: 'https://github.com/openremote/documentation/edit/main/',
           docItemComponent: "@theme/ApiItem", // Derived from docusaurus-theme-openapi
+          ...(process.env.NODE_ENV === 'development' && {
+            onlyIncludeVersions: ['current'],
+          }),
         },
         blog: {
           showReadingTime: true,

package.json

@@ -20,6 +20,7 @@
   },
   "dependencies": {
     "@docusaurus/core": "^3.9.2",
+    "@docusaurus/faster": "^3.9.2",
     "@docusaurus/preset-classic": "^3.9.2",
     "@docusaurus/theme-mermaid": "3.9.2",
     "@mdx-js/react": "^3.0.0",