diff --git a/.gitignore b/.gitignore
index 5cdf5ce..f5a2f20 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,3 +5,10 @@ frontend/*.tsbuildinfo
 backend/__pycache__/
 local-runtime/jobs/*/
 !local-runtime/jobs/.gitkeep
+
+# wrangler files
+.wrangler
+.dev.vars*
+!.dev.vars.example
+.env*
+!.env.example
diff --git a/wrangler.jsonc b/wrangler.jsonc
new file mode 100644
index 0000000..e1fcd8e
--- /dev/null
+++ b/wrangler.jsonc
@@ -0,0 +1,14 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "microfluidic-sim-web",
+  "compatibility_date": "2026-05-25",
+  "observability": {
+    "enabled": true
+  },
+  "assets": {
+    "directory": "frontend"
+  },
+  "compatibility_flags": [
+    "nodejs_compat"
+  ]
+}