diff --git a/.gitignore b/.gitignore
new file mode 100644
index 000000000..30f8da831
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,34 @@
+# Foundry artifacts
+out/
+cache/
+cache_forge/
+
+# Node
+node_modules/
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# Coverage
+coverage/
+lcov.info
+
+# Gas snapshots
+.gas-snapshot
+
+# Broadcast logs
+broadcast/
+
+# Docs output
+docs/
+!docs/*.md
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db