Configuration Guides
Server Configuration
Environment variables, PostgreSQL connection, Redis queue brokers, BYOK provider keys, model fallbacks, and Resend email integration.
Client Configuration
Vite build variables, feature toggles, local storage parameters, authentication flags, and AI model presets.
Architecture Principles
-
Zero Secret Leakage:
The frontend never attempts to read backend environment variables or secrets. Sensitive credentials such as database URLs, Redis brokers, and AI provider API keys remain strictly confined to
backend/.env. -
Cookie-Free Authentication Determination:
Client-side authentication status is determined via state flags and
localStorage.getItem('showMarketingPopup') === 'false', ensuring client scripts never need or attempt to inspect HTTP-only session cookies. - BYOK Security: User-provided third-party API keys (OpenAI, Anthropic, Gemini, OpenRouter) are symmetrically encrypted using AES-256-GCM before database insertion and only decrypted in-memory during review execution.