Client Configuration

The client does not use the backend copy-env command. Copy client/.env.example to client/.env, then set the Vite variables required for your environment.

Configuration Overview Table

Feature / Setting	Option / Key	Where to Toggle	Default Value
Public Repos Tab (Global Env)	`VITE_ENABLE_PUBLIC_REPOS`	`client/.env` / build env	`true`
Public Repos Tab (UI Toggle)	`gobetter_feature_public_repos`	Workspace Settings / `localStorage`	`true`
API Backend Gateway URL	`VITE_API_BASE_URL`	`client/.env`	`http://localhost:5000`
Simulated User Authentication ID	`VITE_USER_ID`	`client/.env`	`00000000-0000-0000-0000-000000000001`
User ID Local Override	`gobe-user-id`	Browser `localStorage`	Unset (fallback to env)
Auth Status / Landing Gate	`showMarketingPopup`	Browser `localStorage`	`'true'` (unauthed) / `'false'` (authed)
Favorited AI Models	`gobe_favorite_model_ids`	Model Picker / `localStorage`	`["gpt-4o", "deepseek-r1", "gemini-2.0-flash"]`
Model Catalog Cache	`gobe_active_model_catalog`	Model Picker / `localStorage`	`DEFAULT_MODEL_CATALOG`
Profile Display Name	`user_profile_name`	Sidebar Profile / `localStorage`	`Developer`
Profile Email Address	`user_profile_email`	Sidebar Profile / `localStorage`	Unset
Email Notifications	`user_email_notification`	Profile Settings / `localStorage`	`true`
Avatar Style Preset	`user_avatar_style`	Sidebar Profile / `localStorage`	`gradient-smooth`
BYOK (Bring Your Own Key) Mode	`useCustomApiKey`	Settings > BYOK Keys / DB	`true`
Auto-Review Pull Requests	`autoReviewPullRequests`	Settings > AI Settings / DB	`true`
Findings Severity Threshold	`severityThreshold`	Settings > AI Settings / DB	`warning`
Quick Review Mode	`lightModeModel`, `lightModePrompt`	Settings > AI Settings / DB	`gpt-4o` (Syntax focus)
Focused Review Mode	`standardModeModel`, `standardModePrompt`	Settings > AI Settings / DB	`deepseek-r1` (Balanced)
Deep Dive Review Mode	`thoroughModeModel`, `thoroughModePrompt`	Settings > AI Settings / DB	`claude-3-7-sonnet` (Deep architecture)

How to Toggle Configurations

1. Toggling the “Try Public Repo” Sandbox Tab

Option A: In the User Interface (Recommended for Users)

In the GoBetter app, navigate to Workspace Settings from the sidebar.
Select the Features tab in the top navigation bar.
Locate the Public Repository Explorer Tab toggle.
Click the switch to toggle between Enabled and Hidden.
- Changes take effect immediately across the sidebar and roadmap view without requiring a page reload.

Option B: In the Environment File (Recommended for Deployments)

To globally lock the tab for all users (e.g. in enterprise environments):

Open or create client/.env (or set environment variables in your deployment runner):
# client/.env VITE_ENABLE_PUBLIC_REPOS=false
When set to false or 0, the tab is permanently hidden and shows as Locked in .env in the Settings UI.

Option C: Programmatically via Browser Console

// Disable the tab
localStorage.setItem('gobetter_feature_public_repos', 'false');
window.dispatchEvent(new CustomEvent('gobetter-config-changed'));

// Re-enable the tab
localStorage.setItem('gobetter_feature_public_repos', 'true');
window.dispatchEvent(new CustomEvent('gobetter-config-changed'));

2. Client Environment Template (`client/.env.example`)

Create client/.env by copying client/.env.example:

cp client/.env.example client/.env

Where to Get Each Frontend Value

Frontend variables are read by Vite at build time and included in the browser JavaScript bundle. They must contain configuration only and never passwords, API keys, database URLs, or tokens.

Variable	Required	How to set it
`VITE_API_BASE_URL`	Yes	Use `http://localhost:5000` locally or the deployed API origin in production. Public configuration.
`VITE_ENABLE_PUBLIC_REPOS`	Optional	Set `true` to enable the Public Repos Explorer or `false`/`0` to lock it globally.
`VITE_USER_ID`	Optional	Use a test user UUID for standalone or mock development only. Real authentication should resolve the user normally.

Update client/.env before running Vite or building the Docker image:

VITE_API_BASE_URL=http://localhost:5000
VITE_ENABLE_PUBLIC_REPOS=true
VITE_USER_ID=00000000-0000-0000-0000-000000000001

The frontend service in Docker Compose is optional and currently commented out. If you enable it, provide client/.env before building so Vite embeds the intended API URL.

# ==========================================
# GoBetter Client Environment Configuration
# ==========================================

# Backend API server URL
VITE_API_BASE_URL=http://localhost:5000

# Feature Flags
# Set to 'false' to switch off the Public Repos Explorer tab
VITE_ENABLE_PUBLIC_REPOS=true

# Authentication (Single-tenant / Mock dev user)
VITE_USER_ID=00000000-0000-0000-0000-000000000001