diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..7264df2
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,6 @@
+# Supabase 환경 설정 예제 파일
+# 이 파일의 이름을 .env.local 로 변경한 뒤, 실제 값을 채워넣으세요.
+# 값 확인: https://supabase.com/dashboard/project/_/settings/api
+
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_ANON_KEY=
diff --git a/.gitignore b/.gitignore
index fe28c50..470b478 100644
--- a/.gitignore
+++ b/.gitignore
@@ -29,6 +29,9 @@ coverage/
 .env.production.local
 .env*.local
 
+# ★ 예제 파일은 공유해야 하므로 예외 처리 (깃에 올라감)
+!.env.example
+
 # ========================================
 # IDE & Editor (에디터 설정)
 # ========================================
@@ -117,5 +120,7 @@ storybook-static/
 .cache/
 node_modules
 
-# Playwright MCP
+# ========================================
+# Custom
+# ========================================
 .playwright-mcp/