diff --git a/.env.schema.json b/.env.schema.json
new file mode 100644
index 0000000..9ea09c2
--- /dev/null
+++ b/.env.schema.json
@@ -0,0 +1,45 @@
+{
+  "version": "1.0",
+  "envVars": [
+    {
+      "name": "DATABASE_URL",
+      "type": "str",
+      "required": true,
+      "description": "PostgreSQL connection string"
+    },
+    {
+      "name": "DATABASE_POOL_SIZE",
+      "type": "int",
+      "required": false,
+      "default": "10",
+      "description": "Database connection pool size"
+    },
+    {
+      "name": "DEBUG_MODE",
+      "type": "bool",
+      "required": false,
+      "default": "false",
+      "description": "Enable debug mode"
+    },
+    {
+      "name": "ALLOWED_HOSTS",
+      "type": "list",
+      "required": false,
+      "description": "Comma-separated list of allowed hosts"
+    },
+    {
+      "name": "API_KEY",
+      "type": "str",
+      "required": true,
+      "pattern": "^[a-zA-Z0-9_-]+$",
+      "description": "API authentication key"
+    },
+    {
+      "name": "LOG_LEVEL",
+      "type": "str",
+      "required": false,
+      "default": "INFO",
+      "description": "Logging level (DEBUG, INFO, WARNING, ERROR)"
+    }
+  ]
+}
\ No newline at end of file