Logo Customization
Learn how to update and manage your brand's logos in LibreApps Desktop.
Overview
LibreApps Desktop uses a centralized approach to logo management. By providing a single logo file, the rebrand engine can propagate it across the entire application, including the sidebar, navigation, and authentication screens.
Supported Formats
- SVG (Recommended): Scalable, lightweight, and looks great on all screens.
- PNG: Good for complex logos with transparency.
- JPG: Not recommended for logos due to lack of transparency.
How to Update
1. Prepare Your Logo
Ensure your logo is named logo.svg (or logo.png). We recommend a square or horizontal aspect ratio.
2. Place in Assets Directory
Copy your logo to rebrand/assets/:
cp my-brand-logo.svg rebrand/assets/logo.svg
3. Run the Rebrand Engine
./scripts/build-rebrand.sh
Advanced: Multiple Logos
If your brand requires different logos for light and dark modes, you can provide:
logo-light.svglogo-dark.svg
The rebrand engine will detect these and update the application logic to switch between them based on the current theme mode.
Best Practices
- ✅ Do this: Use a vector format (SVG) whenever possible.
- ✅ Do this: Ensure your logo has sufficient contrast against both light and dark backgrounds.
- ❌ Don't do this: Use a logo with a hardcoded background color; use transparency instead.