diff --git a/.gitignore b/.gitignore
index 7e6e111ba..64b0b1285 100644
--- a/.gitignore
+++ b/.gitignore
@@ -61,3 +61,10 @@ HANDOFF*.md
 HANDOFF.md
 MARKETING-PROMPT.md
 DISTRIBUTION-PLAYBOOK.md
+
+# wrangler files
+.wrangler
+.dev.vars*
+!.dev.vars.example
+.env*
+!.env.example
diff --git a/wrangler.jsonc b/wrangler.jsonc
new file mode 100644
index 000000000..f11793f07
--- /dev/null
+++ b/wrangler.jsonc
@@ -0,0 +1,14 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "stockyard",
+  "compatibility_date": "2026-04-09",
+  "observability": {
+    "enabled": true
+  },
+  "assets": {
+    "directory": "site"
+  },
+  "compatibility_flags": [
+    "nodejs_compat"
+  ]
+}