diff --git a/.gitignore b/.gitignore
new file mode 100644
index 00000000..474439ba
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,30 @@
+# Dependencies
+node_modules
+docs
+
+# Build
+dist/
+build/
+
+# Environment
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# Logs
+npm-debug.log*
+
+# Claude
+.claude/
+
+# TypeScript files (메인 프로젝트 참조용, 빌드/커밋 제외)
+**/*.ts
+**/*.tsx
+# 단, d.ts 타입 선언 파일은 필요시 포함 가능
+# !**/*.d.ts
\ No newline at end of file