senke/veza
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
veza/apps/web/.env.example

66 lines
2.2 KiB
Text
Raw Normal View History

implicit: implement Implicit 9.1 - document all environment variables - Created .env.example with all required environment variables - Documented API, WebSocket, Stream, Upload configurations - Documented application configuration (name, version) - Documented debug mode and MSW settings - Documented optional variables (FCM, Sentry) - All variables include descriptions and default values - Helps developers set up the project correctly
2026-01-16 12:02:51 +00:00
# Veza Frontend Environment Variables
fix(web): detect wrong server (HTML instead of JSON) and reduce console noise - Detect when API returns HTML (e.g. another app on port 8080): show clear toast and reject so callers get an error instead of broken state - Gate verbose API request/response/slow/error logs on VITE_DEBUG so console is quiet by default in dev; set VITE_DEBUG=true for full logs - Avoid double toast and HTML dump in logs for wrong-server errors - .env.example: clarify VITE_DEBUG enables API request/response logging Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-10 12:52:23 +00:00
# Copy this file to .env.local and update with your values
# --- DOMAIN (single source of truth for frontend) ---
# All service URLs derive from this. Must match APP_DOMAIN in backend .env.
# Change this + /etc/hosts to switch domain.
VITE_DOMAIN=veza.fr
implicit: implement Implicit 9.1 - document all environment variables - Created .env.example with all required environment variables - Documented API, WebSocket, Stream, Upload configurations - Documented application configuration (name, version) - Documented debug mode and MSW settings - Documented optional variables (FCM, Sentry) - All variables include descriptions and default values - Helps developers set up the project correctly
2026-01-16 12:02:51 +00:00
feat(web): externalize feature flags via VITE_FEATURE_* env vars (P3.2) - Parse VITE_FEATURE_* from env with fallback to current defaults - Add all flags to .env.example and ENV_CONFIG.md - parseFeatureEnv accepts true/1/yes for enabled Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-11 21:11:38 +00:00
# --- BACKEND PORT (Vite proxy target) ---
# Must match PORT_BACKEND in docker-compose / config.mk. Default 18080 avoids conflicts.
VITE_BACKEND_PORT=18080
implicit: implement Implicit 9.1 - document all environment variables - Created .env.example with all required environment variables - Documented API, WebSocket, Stream, Upload configurations - Documented application configuration (name, version) - Documented debug mode and MSW settings - Documented optional variables (FCM, Sentry) - All variables include descriptions and default values - Helps developers set up the project correctly
2026-01-16 12:02:51 +00:00
# API Configuration
# Base URL for the REST API (can be absolute URL or path starting with /)
fix(web): detect wrong server (HTML instead of JSON) and reduce console noise - Detect when API returns HTML (e.g. another app on port 8080): show clear toast and reject so callers get an error instead of broken state - Gate verbose API request/response/slow/error logs on VITE_DEBUG so console is quiet by default in dev; set VITE_DEBUG=true for full logs - Avoid double toast and HTML dump in logs for wrong-server errors - .env.example: clarify VITE_DEBUG enables API request/response logging Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-10 12:52:23 +00:00
# DEV: use /api/v1 so the Vite proxy forwards to the backend (same-origin cookies).
implicit: implement Implicit 9.1 - document all environment variables - Created .env.example with all required environment variables - Documented API, WebSocket, Stream, Upload configurations - Documented application configuration (name, version) - Documented debug mode and MSW settings - Documented optional variables (FCM, Sentry) - All variables include descriptions and default values - Helps developers set up the project correctly
2026-01-16 12:02:51 +00:00
VITE_API_URL=/api/v1
# WebSocket Configuration
# WebSocket URL for real-time features (can be absolute URL or path starting with /)
fix(web): detect wrong server (HTML instead of JSON) and reduce console noise - Detect when API returns HTML (e.g. another app on port 8080): show clear toast and reject so callers get an error instead of broken state - Gate verbose API request/response/slow/error logs on VITE_DEBUG so console is quiet by default in dev; set VITE_DEBUG=true for full logs - Avoid double toast and HTML dump in logs for wrong-server errors - .env.example: clarify VITE_DEBUG enables API request/response logging Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-10 12:52:23 +00:00
# If omitted, auto-derived from VITE_DOMAIN: ws://<domain>:8081/ws
implicit: implement Implicit 9.1 - document all environment variables - Created .env.example with all required environment variables - Documented API, WebSocket, Stream, Upload configurations - Documented application configuration (name, version) - Documented debug mode and MSW settings - Documented optional variables (FCM, Sentry) - All variables include descriptions and default values - Helps developers set up the project correctly
2026-01-16 12:02:51 +00:00
VITE_WS_URL=/ws
# Stream Server Configuration
# Stream server URL for audio streaming (can be absolute URL or path starting with /)
fix(web): detect wrong server (HTML instead of JSON) and reduce console noise - Detect when API returns HTML (e.g. another app on port 8080): show clear toast and reject so callers get an error instead of broken state - Gate verbose API request/response/slow/error logs on VITE_DEBUG so console is quiet by default in dev; set VITE_DEBUG=true for full logs - Avoid double toast and HTML dump in logs for wrong-server errors - .env.example: clarify VITE_DEBUG enables API request/response logging Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-10 12:52:23 +00:00
# If omitted, auto-derived from VITE_DOMAIN: ws://<domain>:8082/stream
implicit: implement Implicit 9.1 - document all environment variables - Created .env.example with all required environment variables - Documented API, WebSocket, Stream, Upload configurations - Documented application configuration (name, version) - Documented debug mode and MSW settings - Documented optional variables (FCM, Sentry) - All variables include descriptions and default values - Helps developers set up the project correctly
2026-01-16 12:02:51 +00:00
VITE_STREAM_URL=/stream
# Upload Configuration
# Upload endpoint URL (can be absolute URL or path starting with /)
VITE_UPLOAD_URL=/upload
# Application Configuration
# Application name
VITE_APP_NAME=Veza
# API Version
# API version to use
VITE_API_VERSION=v1
# Debug Mode
fix(web): detect wrong server (HTML instead of JSON) and reduce console noise - Detect when API returns HTML (e.g. another app on port 8080): show clear toast and reject so callers get an error instead of broken state - Gate verbose API request/response/slow/error logs on VITE_DEBUG so console is quiet by default in dev; set VITE_DEBUG=true for full logs - Avoid double toast and HTML dump in logs for wrong-server errors - .env.example: clarify VITE_DEBUG enables API request/response logging Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-10 12:52:23 +00:00
# Enable verbose API request/response logging in console (true/1 or false/0)
implicit: implement Implicit 9.1 - document all environment variables - Created .env.example with all required environment variables - Documented API, WebSocket, Stream, Upload configurations - Documented application configuration (name, version) - Documented debug mode and MSW settings - Documented optional variables (FCM, Sentry) - All variables include descriptions and default values - Helps developers set up the project correctly
2026-01-16 12:02:51 +00:00
VITE_DEBUG=false
# Mock Service Worker
# Enable MSW for API mocking in development (true/1 or false/0)
VITE_USE_MSW=0
# Firebase Cloud Messaging
# VAPID key for push notifications (optional)
# VITE_FCM_VAPID_KEY=your-vapid-key-here
# Sentry Error Tracking
# Sentry DSN for error tracking (optional)
# VITE_SENTRY_DSN=https://your-sentry-dsn@sentry.io/project-id
feat(web): externalize feature flags via VITE_FEATURE_* env vars (P3.2) - Parse VITE_FEATURE_* from env with fallback to current defaults - Add all flags to .env.example and ENV_CONFIG.md - parseFeatureEnv accepts true/1/yes for enabled Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-11 21:11:38 +00:00
# --- Feature Flags (optional, defaults in parens) ---
# Override feature flags without rebuild. Values: true, 1, yes = enabled; else disabled.
# VITE_FEATURE_TWO_FACTOR_AUTH=true
# VITE_FEATURE_PLAYLIST_COLLABORATION=true
# VITE_FEATURE_PLAYLIST_SEARCH=false
# VITE_FEATURE_PLAYLIST_SHARE=false
# VITE_FEATURE_PLAYLIST_RECOMMENDATIONS=false
# VITE_FEATURE_HLS_STREAMING=false
# VITE_FEATURE_ROLE_MANAGEMENT=false
# VITE_FEATURE_NOTIFICATIONS=false
Reference in a new issue Copy permalink