diff --git a/docs/.vitepress/env.d.ts b/docs/.vitepress/env.d.ts
new file mode 100644
index 00000000..2e250754
--- /dev/null
+++ b/docs/.vitepress/env.d.ts
@@ -0,0 +1,9 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_DEBUG: boolean
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
index 0baebd69..2204ad3f 100644
--- a/docs/.vitepress/theme/index.ts
+++ b/docs/.vitepress/theme/index.ts
@@ -8,7 +8,7 @@ export default {
   async enhanceApp({ app }) {
     if (!import.meta.env.SSR) {
       const plugin = await import("../../../src");
-      app.use(plugin, { debug: true });
+      app.use(plugin, { debug: !!import.meta.env.VITE_DEBUG });
     }
   },
 };
diff --git a/package.json b/package.json
index c8720285..a97af69c 100644
--- a/package.json
+++ b/package.json
@@ -52,6 +52,7 @@
     "build": "vite build",
     "serve": "vite preview",
     "docs:dev": "vitepress dev docs",
+    "docs:dev:debug": "VITE_DEBUG=true npm run docs:dev",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",
     "docs:update-requirements": "node scripts/insert-required-versions.mjs README.md docs/get-started.md",