White Label Support

[jasonbrd]

Add White Labeling Support for Custom Branding

Summary

Adds comprehensive white labeling capabilities allowing organizations to customize the application's branding at build time through environment variables. Supports custom logos, default theme selection, and color scheme customization without code modifications.

Features

• Custom Logo Support: Configure custom SVG logos via NEXT_PUBLIC_CUSTOM_LOGO environment variable with automatic fallback to default
• Default Theme Configuration: Set default light/dark theme via NEXT_PUBLIC_DEFAULT_THEME with user preference persistence
• Color Customization: Override application colors through CSS variables - changes apply automatically to all UI components
• Docker Build Integration: Pass branding configuration as build arguments for containerized deployments
• Graceful Fallbacks: All configurations include fallback handling for missing files or invalid values

Technical Changes

• Created Logo component with dynamic source loading and error handling
• Implemented ThemeService for theme management and localStorage persistence
• Updated Tailwind config to use CSS custom properties for runtime color switching
• Modified Dockerfile to accept and pass white label environment variables
• Synchronized theme state across app initialization, user settings, and server responses

Documentation

• Added comprehensive docs/WHITE_LABEL.md with configuration examples and troubleshooting
• Included example logo template at public/logos/example-logo.svg
• Created .env.local.whitelabel.example with all configuration options

Usage Example

docker build \
  --build-arg NEXT_PUBLIC_CUSTOM_LOGO="company-logo.svg" \
  --build-arg NEXT_PUBLIC_DEFAULT_THEME="dark" \
  --build-arg NEXT_PUBLIC_BRAND_NAME="Acme Corp" \
  -t <repo_name> .