updates for caching architecture and docs

Author: ndbroadbent

.github/workflows/ci.yml

@@ -23,17 +23,27 @@ jobs:
         with:
           node-version: "20"
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
       - name: Install rustfmt and clippy
         run: |
           rustup component add rustfmt clippy
 
-      - name: Cache npm dependencies
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        run: |
+          echo "STORE_PATH=$(pnpm store path)" >> "$GITHUB_OUTPUT"
+
+      - name: Cache pnpm dependencies
         uses: actions/cache@v4
         with:
-          path: ~/.npm
-          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-${{ hashFiles('**/pnpm-lock.yaml') }}
           restore-keys: |
-            ${{ runner.os }}-node-
+            ${{ runner.os }}-pnpm-
 
       - name: Cache Nx
         uses: actions/cache@v4
@@ -53,8 +63,8 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-cargo-
 
-      - name: Install npm dependencies
-        run: npm ci
+      - name: Install pnpm dependencies
+        run: pnpm install --frozen-lockfile
 
       - name: Add node_modules/.bin to PATH
         run: echo "$PWD/node_modules/.bin" >> "$GITHUB_PATH"

docs/astro.config.mjs

@@ -53,13 +53,12 @@ export default defineConfig({
           items: [
             { label: 'Overview', slug: 'configuration/overview' },
             { label: 'Cache System', slug: 'configuration/cache' },
+            { label: 'Package Management', slug: 'configuration/packages' },
           ],
         },
         {
           label: 'Providers',
-          items: [
-            { label: 'CircleCI', slug: 'providers/circleci' },
-          ],
+          items: [{ label: 'CircleCI', slug: 'providers/circleci' }],
         },
         {
           label: 'Advanced Features',
@@ -74,9 +73,7 @@ export default defineConfig({
         },
         {
           label: 'Reference',
-          items: [
-            { label: 'Requirements', slug: 'reference/requirements' },
-          ],
+          items: [{ label: 'Requirements', slug: 'reference/requirements' }],
         },
       ],
     }),

docs/biome.jsonc

@@ -1,31 +1,21 @@
 {
   "root": false,
-  "$schema": "https://biomejs.dev/schemas/2.0.6/schema.json",
-  "formatter": {
-    "enabled": true,
-    "formatWithErrors": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineEnding": "lf",
-    "lineWidth": 120
-  },
+  "$schema": "https://biomejs.dev/schemas/2.2.2/schema.json",
+  "extends": ["ultracite"],
   "linter": {
-    "enabled": true,
     "rules": {
       "style": {
         "useFilenamingConvention": "off",
         "noParameterAssign": "error",
         "useAsConstAssertion": "error",
         "useDefaultParameterLast": "error",
+        "useEnumInitializers": "error",
         "useSelfClosingElements": "error",
         "useSingleVarDeclarator": "error",
         "noUnusedTemplateLiteral": "error",
+        "useNumberNamespace": "error",
         "noInferrableTypes": "error",
         "noUselessElse": "error"
-      },
-      "correctness": {
-        "noUnusedVariables": "error",
-        "noUnusedImports": "error"
       }
     }
   },

docs/package.json

@@ -8,11 +8,11 @@
     "build": "astro build",
     "preview": "astro preview",
     "astro": "astro",
-    "lint": "biome lint .",
-    "lint:fix": "biome check --write .",
-    "format": "prettier --write '**/*.{md,mdx,astro}'",
-    "format:check": "prettier --check '**/*.{md,mdx,astro}'",
-    "check": "biome check . && pnpm format:check"
+    "lint": "pnpm exec biome lint .",
+    "lint:fix": "pnpm exec biome check --write .",
+    "format": "pnpm exec prettier --write '**/*.{md,mdx,astro}'",
+    "format:check": "pnpm exec prettier --check '**/*.{md,mdx,astro}'",
+    "check": "pnpm exec biome check . && pnpm format:check"
   },
   "dependencies": {
     "@astrojs/starlight": "^0.35.2",

docs/src/content.config.ts

@@ -1,6 +1,6 @@
-import { defineCollection } from "astro:content";
-import { docsLoader } from "@astrojs/starlight/loaders";
-import { docsSchema } from "@astrojs/starlight/schema";
+import { defineCollection } from 'astro:content';
+import { docsLoader } from '@astrojs/starlight/loaders';
+import { docsSchema } from '@astrojs/starlight/schema';
 
 export const collections = {
   docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),