Onprem documentation

.prettierignore

@@ -37,4 +37,7 @@ archives/
 *.mdx
 
 # Component overrides with custom formatting
-src/components/overrides/Banner.astro
+src/components/overrides/Banner.astro
+
+# prettier-plugin-astro bug: <script is:inline> inside JSX expression causes parse error
+src/components/ui/Tabs.astro

.simple-git-hooks.json

@@ -1,4 +1,4 @@
 {
   "pre-commit": "pnpm pretty-quick --staged",
-  "pre-push": "if [ -n \"$(git status --porcelain)\" ]; then echo \"❌ Error: You have uncommitted changes. Please commit or stash them before pushing.\"; git status --short; exit 1; fi && echo \"Running build before push...\" && pnpm run generate-search-index && pnpm run build && node scripts/log-preview-url.js"
+  "pre-push": "if [ -n \"$(git status --porcelain)\" ]; then echo \"❌ Error: You have uncommitted changes. Please commit or stash them before pushing.\"; git status --short; exit 1; fi && command -v d2 >/dev/null 2>&1 || (echo \"D2 not found, installing...\" && pnpm run install:d2) && echo \"Running build before push...\" && pnpm run generate-search-index && pnpm run build && node scripts/log-preview-url.js"
 }

CONTRIBUTING.md

@@ -47,6 +47,8 @@ A few things worth knowing before you dive in:
 npm install -g pnpm
 ```
 
+Optionally, use [Volta](https://volta.sh) to manage Node and pnpm versions automatically — the project's `package.json` already has the correct versions pinned.
+
 ### Clone and run
 
 ```bash

README.md

@@ -70,6 +70,8 @@ developer-docs/
 npm install -g pnpm
 ```
 
+Optionally, use [Volta](https://volta.sh) to manage Node and pnpm versions automatically — the project's `package.json` already has the correct versions pinned.
+
 #### Run locally
 
 ```bash

package.json

@@ -47,7 +47,6 @@
     "astro-og-canvas": "^0.10.1",
     "canvaskit-wasm": "0.40.0",
     "jose": "^6.2.2",
-    "pnpm": "^10.33.0",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "sharp": "^0.34.5",
@@ -83,6 +82,10 @@
     "simple-git-hooks": "^2.13.1",
     "unified": "^11.0.5"
   },
+  "volta": {
+    "node": "24.15.0",
+    "pnpm": "10.33.0"
+  },
   "pnpm": {
     "onlyBuiltDependencies": [
       "sharp",