diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
new file mode 100644
index 0000000..8a0f315
--- /dev/null
+++ b/pnpm-workspace.yaml
@@ -0,0 +1,9 @@
+# pnpm 10+ moved several settings out of package.json's "pnpm" field into
+# this file. `onlyBuiltDependencies` allow-lists packages permitted to run
+# install/build scripts (pnpm now blocks build scripts by default). Without
+# this, better-sqlite3's native binary is never compiled and the server
+# crashes at runtime with ERR_DLOPEN_FAILED / NODE_MODULE_VERSION mismatch.
+onlyBuiltDependencies:
+  - better-sqlite3
+  - esbuild
+  - sharp