diff --git a/frontend/.env.example b/frontend/.env.example
new file mode 100644
index 0000000..0a763fd
--- /dev/null
+++ b/frontend/.env.example
@@ -0,0 +1,18 @@
+# Supabase Configuration
+# You can find these in your Supabase project settings -> API
+NEXT_PUBLIC_SUPABASE_URL=your-project-url.supabase.co
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
+
+# Robot Connection (Optional - defaults listed below)
+# The IP address of your robot running the ROS2 stack
+# NEXT_PUBLIC_ROS_IP=192.168.1.95
+# The port for the ROS bridge WebSocket (default 9090)
+# NEXT_PUBLIC_ROS_PORT=9090
+
+# App Configuration
+# The URL of your frontend application
+# NEXT_PUBLIC_APP_URL=http://localhost:3000
+
+# BotBrain Edition
+# Set to 'pro' for professional features, leave empty/unset for Open Source edition
+# BOTBRAIN_EDITION=oss
diff --git a/frontend/.gitignore b/frontend/.gitignore
index 5ef6a52..f4956e0 100644
--- a/frontend/.gitignore
+++ b/frontend/.gitignore
@@ -30,8 +30,13 @@ yarn-debug.log*
 yarn-error.log*
 .pnpm-debug.log*
 
-# env files (can opt-in for committing if needed)
-.env*
+# env files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+!.env.example
 
 # vercel
 .vercel