diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..ce2075a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,28 @@
+# --- OS files ---
+.DS_Store
+Thumbs.db
+
+# --- Editor / IDE ---
+.vscode/
+.idea/
+*.swp
+
+# --- Python ---
+__pycache__/
+*.pyc
+
+# --- Node ---
+node_modules/
+
+# --- Docker ---
+*.env
+
+# --- Backup / temp ---
+*.bak
+*.tmp
+~*
+
+# --- ESPHome build artifacts (globally ignored) ---
+.esphome/
+.pioenvs/
+.pio/