diff --git a/scripts/typedoc-plugin-evolu.test.mts b/scripts/typedoc-plugin-evolu.test.mts
index 18a4993c4..f97a8c3ea 100644
--- a/scripts/typedoc-plugin-evolu.test.mts
+++ b/scripts/typedoc-plugin-evolu.test.mts
@@ -7,6 +7,10 @@ import { describe, expect, it } from "vitest";
  *
  * These tests verify the generated documentation. Run `bun run build:docs` before
  * running these tests.
+ *
+ * NOTE: This test is excluded from the regular test run in vitest.config.mts
+ * because it requires generated docs. It runs explicitly in the verify script
+ * after `bun run build:docs`.
  */
 
 const docsPath = join(
diff --git a/vitest.config.mts b/vitest.config.mts
index 60c2fe827..0a7477c25 100644
--- a/vitest.config.mts
+++ b/vitest.config.mts
@@ -12,6 +12,9 @@ export default defineConfig({
         test: {
           name: "scripts",
           include: ["scripts/**/*.test.mts"],
+          // Exclude typedoc test because it requires generated docs.
+          // It runs explicitly after build:docs in the verify script.
+          exclude: ["scripts/typedoc-plugin-evolu.test.mts"],
         },
       },
     ],