Switch root docs workflow and site from npm to Bun

.github/workflows/build.yml

@@ -61,15 +61,23 @@ jobs:
         with:
           fetch-depth: 1
 
-      - name: Set up Node.js
-        uses: actions/setup-node@v6
+      - name: Install Bun
+        uses: oven-sh/setup-bun@v2
         with:
-          node-version: 24
-          cache: npm
-          cache-dependency-path: package-lock.json
+          bun-version: latest
+
+      - name: Restore Bun dependency cache
+        uses: actions/cache@v5
+        with:
+          path: |
+            node_modules
+            ~/.bun/install/cache
+          key: bun-docs-${{ runner.os }}-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            bun-docs-${{ runner.os }}-
 
       - name: Install docs dependencies
-        run: npm ci
+        run: bun install --frozen-lockfile
 
       - name: Read VERSION
         id: ver
@@ -79,7 +87,7 @@ jobs:
           echo "version=${base}${{ inputs.version_suffix }}" >> "$GITHUB_OUTPUT"
 
       - name: Build docs site
-        run: npm run build
+        run: bun run build
 
       - name: Package docs site
         shell: bash

.github/workflows/docs.yml

@@ -11,7 +11,7 @@ on:
       - 'docusaurus.config.ts'
       - 'sidebars.ts'
       - 'package.json'
-      - 'package-lock.json'
+      - 'bun.lock'
       - 'tsconfig.json'
       - '.github/workflows/docs.yml'
       - '.github/workflows/build.yml'
@@ -23,7 +23,7 @@ on:
       - 'docusaurus.config.ts'
       - 'sidebars.ts'
       - 'package.json'
-      - 'package-lock.json'
+      - 'bun.lock'
       - 'tsconfig.json'
       - '.github/workflows/docs.yml'
       - '.github/workflows/build.yml'
@@ -51,21 +51,29 @@ jobs:
         with:
           fetch-depth: 1
 
-      - name: Set up Node.js
-        uses: actions/setup-node@v6
+      - name: Install Bun
+        uses: oven-sh/setup-bun@v2
         with:
-          node-version: 24
-          cache: npm
-          cache-dependency-path: package-lock.json
+          bun-version: latest
+
+      - name: Restore Bun dependency cache
+        uses: actions/cache@v5
+        with:
+          path: |
+            node_modules
+            ~/.bun/install/cache
+          key: bun-docs-${{ runner.os }}-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            bun-docs-${{ runner.os }}-
 
       - name: Install dependencies
-        run: npm ci
+        run: bun install --frozen-lockfile
 
       - name: Build docs site
         env:
           DOCS_URL: https://bybrooklyn.github.io
           DOCS_BASE_URL: /alchemist/
-        run: npm run build
+        run: bun run build
 
       - name: Upload built site artifact
         uses: actions/upload-artifact@v7

.gitignore

@@ -12,8 +12,7 @@ build/
 test-results/
 yarn.lock
 pnpm-lock.yaml
-!/package-lock.json
-/bun.lock
+package-lock.json
 
 # Data & Runtime
 .runtime/
@@ -24,7 +23,6 @@ web.zip
 # Logs
 error.txt
 build_log_*.txt
-npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 

package.json

@@ -2,6 +2,7 @@
   "name": "alchemist-docs",
   "version": "0.3.0-dev.3",
   "private": true,
+  "packageManager": "bun@1.3.5",
   "scripts": {
     "docusaurus": "docusaurus",
     "start": "docusaurus start",
@@ -21,7 +22,9 @@
     "clsx": "^2.0.0",
     "prism-react-renderer": "^2.3.0",
     "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react-dom": "^19.0.0",
+    "react-helmet-async": "npm:@slorber/react-helmet-async@1.3.0",
+    "react-loadable": "npm:@docusaurus/react-loadable@6.0.0"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.9.2",

redoc/contributing/development.md

@@ -16,7 +16,7 @@ Alchemist is built using:
 
 To work on Alchemist, you'll need:
 1.  **Rust**: Install via [rustup](https://rustup.rs/).
-2.  **Bun**: Used for front-end package management (`npm install -g bun`).
+2.  **Bun**: Used for front-end package management (install via the official Bun installer).
 3.  **FFmpeg**: Installed on your system (for local testing).
 
 ## Local Development