Branding & White Label – Media Storage App

⚙️Environment Variables

Set these in your .env file (or via deployment environment) to change visible branding instantly:

# Basic Identity
BRAND_NAME="My Awesome Media Portal"
BRAND_TAGLINE="Secure. Fast. Yours."

# Logo (file inside /logo directory)
BRAND_LOGO=logo.png

# Colors (hex codes)
BRAND_PRIMARY_COLOR=#1e88e5
BRAND_ACCENT_COLOR=#42a5f5

BRAND_NAME: Appears in the top navbar and login header.
BRAND_TAGLINE: Subtitle below logo on login page.
BRAND_LOGO: File name inside the logo/ folder (served at /logo/<file>).
BRAND_PRIMARY_COLOR: Main gradient/button color.
BRAND_ACCENT_COLOR: Secondary gradient/button hover color.

🖼️Changing the Logo

Place your image (e.g. company.png) in the logo/ folder.
Set BRAND_LOGO=company.png in .env.
Restart the app (or reload if using --reload).

Tip: Recommended size: square 256×256 PNG with transparent background.

🎨Updating Colors

The navbar gradient and primary buttons use the two color variables. Pick accessible contrasting colors.

# Example palette
BRAND_PRIMARY_COLOR=#673ab7
BRAND_ACCENT_COLOR=#9575cd

Contrast: Ensure white text remains readable; test quickly in the browser.

🔄Applying Changes

If running with uvicorn --reload, changes apply on next request. Otherwise:

# Restart (manual example)
Ctrl + C
uvicorn main:app --reload

🧪Quick Test Checklist

☑️ New logo displays in navbar & login page
☑️ Brand name updated across pages
☑️ Tagline visible under logo on login
☑️ Colors applied to navbar & primary buttons
☑️ API still functional (branding doesn't affect logic)

❓FAQ

Do I need to rebuild anything?

No. Only restart the server if not using auto-reload.

Can I add more variables?

Yes—add to .env, update main.py to inject them into templates.env.globals, then reference in templates.

Can I remove branding entirely?

Set minimal values (e.g. blank tagline, neutral colors) or replace the logo with a transparent PNG.

🎨 Branding & White Label