diff --git a/docs/.gitignore b/docs/.gitignore
index b2d6de3..93de2e8 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -7,6 +7,7 @@
 # Generated files
 .docusaurus
 .cache-loader
+.cache/
 
 # Misc
 .DS_Store
@@ -18,3 +19,4 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+pnpm-debug.log*
diff --git a/docs/.npmrc b/docs/.npmrc
deleted file mode 100644
index 95fd4ae..0000000
--- a/docs/.npmrc
+++ /dev/null
@@ -1,3 +0,0 @@
-# Docusaurus + pnpm: hoist transitive deps (feed, etc.) so jiti/webpack resolve them.
-shamefully-hoist=true
-strict-peer-dependencies=false
diff --git a/docs/package.json b/docs/package.json
index 5281b40..65ee502 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -35,23 +35,6 @@
     "@docusaurus/types": "3.10.2",
     "typescript": "~5.6.2"
   },
-  "pnpm": {
-    "overrides": {
-      "webpackbar": "^7.0.0",
-      "js-yaml": "4.3.2",
-      "fast-uri": "3.1.7",
-      "svgo": "3.3.5",
-      "qs": "6.16.0",
-      "serialize-javascript": "7.0.5",
-      "image-size": "npm:image-size-next@2.1.1",
-      "colord": "2.9.4",
-      "joi": "17.13.8"
-    },
-    "onlyBuiltDependencies": [
-      "@swc/core",
-      "core-js"
-    ]
-  },
   "browserslist": {
     "production": [
       ">0.5%",
diff --git a/docs/pnpm-workspace.yaml b/docs/pnpm-workspace.yaml
new file mode 100644
index 0000000..5ccca81
--- /dev/null
+++ b/docs/pnpm-workspace.yaml
@@ -0,0 +1,20 @@
+packages:
+  - '.'
+
+shamefullyHoist: true
+strictPeerDependencies: false
+
+allowBuilds:
+  '@swc/core': true
+  core-js: true
+
+overrides:
+  webpackbar: ^7.0.0
+  js-yaml: 4.3.2
+  fast-uri: 3.1.7
+  svgo: 3.3.5
+  qs: 6.16.0
+  serialize-javascript: 7.0.5
+  image-size: npm:image-size-next@2.1.1
+  colord: 2.9.4
+  joi: 17.13.8