diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e4a40bf
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,52 @@
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+desktop.ini
+
+# Editor directories and temp files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+
+# Dependency directories
+node_modules/
+vendor/
+
+# Coverage directory used by tools like istanbul
+coverage/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Sensitive configs (keep these!)
+# .env.production  # If you want to track prod configs
+
+# zsh
+/.zsh-history
+/.zsh_sessions/
+
+# Firefox (sensitive, usually ignore)
+# ~/.mozilla/firefox/*.default-release/sessionstore*
+
+# SSH keys (NEVER track)
+# ~/.ssh/id_*