diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e0ba4b6
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,24 @@
+# macOS
+.DS_Store
+._*
+
+# Editor / IDE
+.vscode/
+.idea/
+*.swp
+
+# Mintlify CLI cache + local previews
+.mintlify/
+mintlify-*.log
+
+# Node (Mintlify CLI runs locally)
+node_modules/
+.npm/
+
+# Local env / secrets
+.env
+.env.local
+
+# OS / scratch
+*.bak
+*.tmp