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

83 lines
2.8 KiB
Text
Raw Permalink 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
feat(chat): Sprint 4 -- Docker cleanup, frontend migration to Go WS - Remove Rust chat-server from docker-compose.yml, staging.yml, prod.yml - Remove VITE_WS_URL from docker frontend env vars (auto-derived from API_URL) - Update env.ts: derive WS_URL from API_URL (/api/v1/ws) when not explicitly set - Remove 127.0.0.1:8081 dev hack from useChat.ts - Add missing types: EditMessage, DeleteMessage, FetchHistory, SearchMessages, SyncMessages, MessageEdited, MessageDeleted, SearchResults, SyncChunk - Update MSW chat/token handler to return ws_url: /api/v1/ws - Update .env.example and .env.storybook
2026-02-22 19:46:58 +00:00
# Chat WebSocket URL. If omitted, auto-derived from VITE_API_URL + /ws
# v0.502: Chat WS is now served by the Go backend at /api/v1/ws
# VITE_WS_URL=/api/v1/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
# 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
fix(security): add JWT auth to HLS endpoints (audit 1.3, P0) - Add hls_auth_middleware in stream server (Bearer + ?token=) - Apply auth to /hls/:track_id/* routes - Update frontend hlsService to use stream server URL + pass JWT via xhrSetup - Add getHLSXhrSetup() and getHLSURLWithToken() for hls.js integration - Add VITE_HLS_BASE_URL config (derived from VITE_STREAM_URL when unset) - Add unit tests for token extraction and HLS helpers - Mark audit item 1.3 as done
2026-02-15 11:48:58 +00:00
# HLS Base URL (optional)
# HTTP base URL for HLS streaming (master.m3u8, playlists, segments). Auth required (JWT).
fix(streaming): ensure HLS audio chain works end-to-end - HAProxy: route /hls to stream server - Vite proxy: /ws, /stream, /hls for dev - HLS_BASE_URL: empty when STREAM_URL relative (proxy) - FEATURE_STATUS: HLS_STREAMING operational
2026-02-18 11:42:42 +00:00
# If omitted, derived from VITE_STREAM_URL. For Docker dev (port 18082): use /hls (Vite proxy) or http://localhost:18082
# VITE_HLS_BASE_URL=http://localhost:18082
# VITE_CHAT_PORT=18081
# VITE_STREAM_PORT=18082
fix(security): add JWT auth to HLS endpoints (audit 1.3, P0) - Add hls_auth_middleware in stream server (Bearer + ?token=) - Apply auth to /hls/:track_id/* routes - Update frontend hlsService to use stream server URL + pass JWT via xhrSetup - Add getHLSXhrSetup() and getHLSURLWithToken() for hls.js integration - Add VITE_HLS_BASE_URL config (derived from VITE_STREAM_URL when unset) - Add unit tests for token extraction and HLS helpers - Mark audit item 1.3 as done
2026-02-15 11:48:58 +00:00
feat(web): add CDN support for assets and audio - Add VITE_CDN_URL, VITE_CDN_ENABLED to .env.example - Create getAssetURL, getAudioURL in utils/cdn.ts - Use getAudioURL in hlsService for HLS stream URLs
2026-02-14 21:44:06 +00:00
# CDN Configuration (optional)
# Base URL for CDN when serving assets/audio from edge. Backend typically provides CDN URLs for tracks.
# VITE_CDN_URL=https://cdn.veza.com
# VITE_CDN_ENABLED=false
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
# Upload Configuration
# Upload endpoint URL (can be absolute URL or path starting with /)
VITE_UPLOAD_URL=/upload
chore: consolidate pending changes (Hyperswitch, PostCard, dashboard, stream server, etc.)
2026-02-14 20:45:15 +00:00
# Hyperswitch (Payments)
# Publishable key from Hyperswitch Control Center - for payment widget
# Leave empty if payments disabled
VITE_HYPERSWITCH_PUBLISHABLE_KEY=
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
# 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
fix(streaming): ensure HLS audio chain works end-to-end - HAProxy: route /hls to stream server - Vite proxy: /ws, /stream, /hls for dev - HLS_BASE_URL: empty when STREAM_URL relative (proxy) - FEATURE_STATUS: HLS_STREAMING operational
2026-02-18 11:42:42 +00:00
# VITE_FEATURE_HLS_STREAMING=true
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
# VITE_FEATURE_ROLE_MANAGEMENT=false
# VITE_FEATURE_NOTIFICATIONS=false
Reference in a new issue Copy permalink