Skip to main content

Asset Management Overview

How LibreApps Desktop handles logos, favicons, and other brand assets.

Overview​

The LibreApps Desktop Rebrand Engine automates the process of injecting your brand's visual assets into the application. By placing your files in the rebrand/assets/ directory, you can ensure they are correctly processed and deployed.

Key Assets​

1. Logos​

  • File: rebrand/assets/logo.svg (or .png)
  • Usage: Displayed in the sidebar, navigation bar, and login pages.

2. Favicons​

  • File: rebrand/assets/favicon.ico
  • Usage: The icon displayed in the browser tab.

3. Login Backgrounds​

  • File: rebrand/assets/login-bg.jpg
  • Usage: The background image for the authentication pages.
  • Directory: rebrand/assets/gallery/
  • Usage: Preview images for the Theme Gallery cards.

How Assets are Injected​

When you run ./scripts/build-rebrand.sh, the engine:

  1. Scans the rebrand/assets/ directory.
  2. Copies the files to the appropriate locations in the build/web/rebranded/public/ directory.
  3. Updates any internal references to these assets in the source code.

Best Practices​

  • ✅ Do this: Use high-resolution images for logos and backgrounds.
  • ✅ Do this: Prefer SVG for logos to ensure they are scalable and lightweight.
  • ❌ Don't do this: Manually copy assets into the public/ folder; the rebrand engine will handle this for you.