diff --git a/.gitignore b/.gitignore
index 868603305..67e3fe530 100644
--- a/.gitignore
+++ b/.gitignore
@@ -25,3 +25,8 @@ mail-vue/node_modules
 mail-vue/dist
 .wrangler
 .venv
+
+.dev.vars*
+!.dev.vars.example
+.env*
+!.env.example
diff --git a/wrangler.jsonc b/wrangler.jsonc
new file mode 100644
index 000000000..cc1d4e493
--- /dev/null
+++ b/wrangler.jsonc
@@ -0,0 +1,14 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "wodemail",
+  "compatibility_date": "2026-04-03",
+  "observability": {
+    "enabled": true
+  },
+  "assets": {
+    "directory": "mail-vue"
+  },
+  "compatibility_flags": [
+    "nodejs_compat"
+  ]
+}