diff --git a/.gitignore b/.gitignore
new file mode 100644
index 00000000..a4d8e1b9
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,26 @@
+# Godot
+.godot/
+*.import
+
+# Build artifacts
+builds/*
+!builds/.gitkeep
+
+# Test output
+test_output/
+
+# Environment (dev overrides, secrets)
+.env
+.env.*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor
+*.swp
+*.swo
+*~
+
+# Auto-added by auto-commit-service
+node_modules/