diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..a439675
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,18 @@
+# Optional: public site URL when reverse proxy does not send X-Forwarded-* (fixes post-login redirects).
+# Example: https://kickkings.playpoolstudios.com
+# APP_ORIGIN=
+
+# Supabase project URL (public)
+NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
+
+# Service role key — server only; never expose to the browser. Used to read
+# users/matches for this admin UI (bypasses RLS). Get it from Supabase Dashboard → Settings → API.
+SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
+
+# Directory containing per-match logs as <matchId>.txt (server filesystem path).
+# Example: /home/react/KickKings/games/soccar/soccar_Data/Logs
+# MATCH_LOGS_DIR=
+
+# Directory containing matchmaker logs: history.log (processed) and matchmaker.log (raw).
+# Example: /var/www/html/kickkings/logs/matchmaker/logs
+# MATCHMAKER_LOGS_DIR=