https://github.com/johlc/transparentblue
Transparent Blue is a sleek, modern theme for Home Assistant featuring a transparent blue aesthetic.
https://github.com/johlc/transparentblue
hacs home-assistant home-automation homeassistant homeassistant-addons theme transparent-blue-theme transparentblue yaml
Last synced: 4 months ago
JSON representation
Transparent Blue is a sleek, modern theme for Home Assistant featuring a transparent blue aesthetic.
- Host: GitHub
- URL: https://github.com/johlc/transparentblue
- Owner: JOHLC
- License: mit
- Created: 2020-10-24T15:34:42.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2026-01-16T03:20:24.000Z (5 months ago)
- Last Synced: 2026-02-28T17:25:57.919Z (4 months ago)
- Topics: hacs, home-assistant, home-automation, homeassistant, homeassistant-addons, theme, transparent-blue-theme, transparentblue, yaml
- Homepage:
- Size: 40.5 MB
- Stars: 32
- Watchers: 3
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Transparent Blue Theme for Home Assistant
[](https://github.com/custom-components/hacs)
---
## Overview
**Transparent Blue** is a sleek, modern theme for Home Assistant featuring a transparent blue aesthetic.
It’s my first custom theme for Home Assistant and my first ever GitHub/HACS repository.
- **Report issues:** [GitHub Issues](https://github.com/JOHLC/transparentblue/issues)
- **Community & feedback:** [HA Community Thread](https://community.home-assistant.io/t/transparent-blue-custom-theme/)
---
## Screenshots
| Main | More Info |
|------|-----------|
| 
| 
|
| Sidebar | Menu |
|---------|------|
| 
| 
|
[Included background image](https://github.com/JOHLC/transparentblue/blob/main/images/background.jpg)
---
## Quick Start
> **Recommended:** Install via HACS for easiest setup and updates.
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=JOHLC&repository=transparentblue&category=frontend)
1. Open HACS in Home Assistant
2. Go to **Frontend**
3. Click **Add (+)**
4. Search for **Transparent Blue**
5. Click **Download**
6. Select the theme in Home Assistant
---
## Manual Installation (not recommended)
1. Download `transparentblue.yaml` from the [latest release](https://github.com/JOHLC/transparentblue/releases).
2. Upload to your `themes` directory.
3. Add the resource reference to your Lovelace config.
4. Select the theme in Home Assistant.
---
## Customizing the Background
To change your background, edit this line in your `.yaml`:
```
lovelace-background: 'center / cover no-repeat fixed url("")'
```
**With local or remote image:**
```
lovelace-background: 'center / cover no-repeat fixed url("/local/background.png")'
# or
lovelace-background: 'center / cover no-repeat fixed url("https://example.com/background.jpg")'
```
**With base64:**
```
lovelace-background: 'center / cover no-repeat fixed url("data:image/png;base64,YOURLONGSTRING")'
```
---
## Beta Versions
Beta releases may be available for testing.
Enable/disable beta versions in HACS via **Show beta versions** setting.
---
## Compatibility
Tested on Home Assistant 2026.x and newer.
---
## Contributing
We welcome contributions to improve the Transparent Blue theme! Please read our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md) before submitting pull requests.
### How to Contribute
- Report bugs via [GitHub Issues](https://github.com/JOHLC/transparentblue/issues)
- Suggest features via [Feature Requests](https://github.com/JOHLC/transparentblue/issues/new/choose)
- Submit improvements via [Pull Requests](https://github.com/JOHLC/transparentblue/pulls)
---
## Support
- **Issues & Bug Reports**: [GitHub Issues](https://github.com/JOHLC/transparentblue/issues)
- **Community Discussion**: [Home Assistant Community](https://community.home-assistant.io/t/transparent-blue-custom-theme/)
- **Documentation**: This README and inline comments in the theme file
---
## License
This theme is released under the [MIT License](LICENSE). Feel free to use, modify, and distribute as per the license terms.
---
## Other Cool Themes
- [3ative Blue Theme](https://github.com/3ative/3ative-blue-theme)
- [Clear Theme Dark](https://github.com/naofireblade/clear-theme-dark)
---
## Acknowledgments
- Thanks to the Home Assistant community for feedback and testing
- Inspired by various blue themes in the Home Assistant ecosystem
---
> _PRs, suggestions, and feedback are always welcome!_