diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..25f53a3
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,30 @@
+# Generated by Cargo
+# will cover compiled files and intermediates
+target/
+Cargo.lock
+
+# Remove package-lock to avoid confusion
+# (we use Cargo.lock exclusively)
+package-lock.json
+
+# These are backup files generated by the editor
+*.swp
+*.swo
+*~
+
+# IDE files
+.idea/
+.vscode/
+*.code-workspace
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Test artifacts
+coverage/
+*.lcov
+htmlcov/
+
+# Local vault files (contain sensitive data)
+~/.config/api-token-vault/