diff --git a/.changeset/tidy-pears-yawn.md b/.changeset/tidy-pears-yawn.md
new file mode 100644
index 00000000..2b9b8b77
--- /dev/null
+++ b/.changeset/tidy-pears-yawn.md
@@ -0,0 +1,5 @@
+---
+"codehike": patch
+---
+
+Declare zod as a peer dependency because `codehike/blocks` imports it at runtime and exposes zod v3 schema types.
diff --git a/packages/codehike/package.json b/packages/codehike/package.json
index 325a5119..0a38beb6 100644
--- a/packages/codehike/package.json
+++ b/packages/codehike/package.json
@@ -59,6 +59,9 @@
     "mdast-util-mdx-jsx": "^3.0.0",
     "unist-util-visit": "^5.0.0"
   },
+  "peerDependencies": {
+    "zod": "^3.22.4"
+  },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.15.4",
     "@mdx-js/mdx": "^3.0.0",