Add details of dark variants to readme (#6751)

* Add details of dark variants

* Revert to original formatting
This commit is contained in:
Andrew Jackson 2025-03-16 19:57:04 +00:00 committed by GitHub
parent fd11d3a728
commit e6a114ac5b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -22,23 +22,35 @@ Each of these two main folders contain domain folders. Each domain folder is
named to the integration `domain` and must match the domain set in the
integration `manifest.json` file.
A domain folder can contain four files:
A domain folder can contain eight files:
- `icon.png`: A square avatar-like icon, representing the brand or product for that domain.
- `dark_icon.png`: Dark optimised icon (if required).
- `logo.png`: The logo of the brand or product for that domain.
- `dark_logo.png`: Dark optimised logo (if required).
- `icon@2x.png`: hDPI version of `icon.png`
- `dark_icon@2x.png`: hDPI version of `dark_icon.png`
- `logo@2x.png`: hDPI version of `logo.png`
- `dark_logo@2x.png`: hDPI version of `dark_logo.png`
Those images are served in the following format:
- `https://brands.home-assistant.io/[domain]/icon.png`
- `https://brands.home-assistant.io/[domain]/dark_icon.png`
- `https://brands.home-assistant.io/[domain]/logo.png`
- `https://brands.home-assistant.io/[domain]/dark_logo.png`
- `https://brands.home-assistant.io/[domain]/icon@2x.png`
- `https://brands.home-assistant.io/[domain]/dark_icon@2x.png`
- `https://brands.home-assistant.io/[domain]/logo@2x.png`
- `https://brands.home-assistant.io/[domain]/dark_logo@2x.png`
- `https://brands.home-assistant.io/_/[domain]/icon.png`
- `https://brands.home-assistant.io/_/[domain]/dark_icon.png`
- `https://brands.home-assistant.io/_/[domain]/logo.png`
- `https://brands.home-assistant.io/_/[domain]/dark_logo.png`
- `https://brands.home-assistant.io/_/[domain]/icon@2x.png`
- `https://brands.home-assistant.io/_/[domain]/dark_icon@2x.png`
- `https://brands.home-assistant.io/_/[domain]/logo@2x.png`
- `https://brands.home-assistant.io/_/[domain]/dark_logo@2x.png`
### Missing image handling
@ -72,7 +84,7 @@ For example: <`https://brands.home-assistant.io/_/[domain]/icon.png`>
All icons and logos are cached by browsers for 7 days, so additions and changes may take time to reach all users. This gives users the full benefits of local caching with minimal revalidation, and protects against missing content during an internet outage.
Images are simultaneously cached by Cloudflare for 24 hours. This allows changes to begin being distributed to users relatively quickly without losing the CDN benefits. It also guarantees a simple refresh (F5) will bring content no more than 1 day old.
Images are simultaneously cached by Cloudflare for 24 hours. This allows changes to begin being distributed to users relatively quickly without losing the CDN benefits. It also guarantees a simple refresh (F5) will bring content no more than 1 day old.
The Cloudflare cache is also fully flushed in each major version of Home Assistant Core.