diff --git a/.env.example b/.env.example
index 83145f284ae..48632b5477c 100644
--- a/.env.example
+++ b/.env.example
@@ -1,29 +1,49 @@
-# Database
-DATABASE_URL=postgresql://postgres:postgres@localhost:5432/superset
-DATABASE_URL_UNPOOLED=postgresql://postgres:postgres@localhost:5432/superset
-
-# Neon (for database branching)
-NEON_API_KEY=your_neon_api_key_here
-NEON_ORG_ID=your_neon_org_id_here
-NEON_PROJECT_ID=your_neon_project_id_here
-NEON_BRANCH_ID=your_neon_branch_id_here
-
-# Clerk Authentication
-CLERK_SECRET_KEY=your_clerk_secret_key_here
-CLERK_WEBHOOK_SECRET=your_clerk_webhook_secret_here
-NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key_here
-
-# App URLs
-NEXT_PUBLIC_WEB_URL=http://localhost:3000
+
+
+# =============================================================================
+# ROOT SUPERSET ENV
+# Shared by all worktrees via direnv
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Neon Organization Credentials
+# -----------------------------------------------------------------------------
+NEON_ORG_ID=
+NEON_PROJECT_ID=
+NEON_API_KEY=
+
+# -----------------------------------------------------------------------------
+# Neon Database Credentials (Production)
+# -----------------------------------------------------------------------------
+DATABASE_URL=
+DATABASE_URL_UNPOOLED=
+
+# -----------------------------------------------------------------------------
+# Cross-App URLs (Local Dev)
+# -----------------------------------------------------------------------------
 NEXT_PUBLIC_API_URL=http://localhost:3001
-NEXT_PUBLIC_ADMIN_URL=http://localhost:3002
-NEXT_PUBLIC_MARKETING_URL=http://localhost:3003
+NEXT_PUBLIC_WEB_URL=http://localhost:3000
+NEXT_PUBLIC_ADMIN_URL=http://localhost:3003
+NEXT_PUBLIC_MARKETING_URL=http://localhost:3002
 NEXT_PUBLIC_DOCS_URL=http://localhost:3004
+
+# -----------------------------------------------------------------------------
+# Clerk Auth
+# -----------------------------------------------------------------------------
+NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
+CLERK_SECRET_KEY=
+CLERK_WEBHOOK_SECRET=
 NEXT_PUBLIC_COOKIE_DOMAIN=localhost
 
-# Vercel Blob Storage
-BLOB_READ_WRITE_TOKEN=your_blob_token_here
+# -----------------------------------------------------------------------------
+# Blob Storage
+# -----------------------------------------------------------------------------
+BLOB_READ_WRITE_TOKEN=
 
-# Desktop App
-VITE_DEV_SERVER_PORT=4927
-DESKTOP_AUTH_SECRET=your_desktop_auth_secret_here_min_32_chars
+# -----------------------------------------------------------------------------
+# PostHog Analytics (Local Dev)
+# -----------------------------------------------------------------------------
+NEXT_PUBLIC_POSTHOG_KEY=
+POSTHOG_API_KEY=
+POSTHOG_PROJECT_ID=
+DESKTOP_AUTH_SECRET=