diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..917a3cc
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,33 @@
+# deps
+node_modules/
+.pnpm-store/
+
+# build outputs
+dist/
+.next/
+.turbo/
+*.tsbuildinfo
+
+# env files: per project decision, .env.development and .env.production
+# ARE committed to this private Gitea. Only ignore example overrides:
+.env.local
+.env.*.local
+
+# logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+# editor
+.vscode/
+.idea/
+*.swp
+.DS_Store
+
+# runtime data (mounted volumes from compose)
+dev-data/
+data/
+
+# test coverage
+coverage/
+.vitest-cache/