Vane

A clean, minimal Home Assistant theme with matching light and dark modes.

Table of Contents

1. About The Project
   • Features
   • Screenshots
2. Installation
   • HACS (recommended)
   • Manual
3. Customizing
4. Contributing
5. License

About The Project

Vane is a Home Assistant frontend theme focused on a clean, minimal look with first-class light and dark mode support.

Features

• Matching light & dark palettes — one theme, two fully designed modes
• Domain accent colors — distinct, consistent colors for lights, covers, climate, and media players
• Broad coverage — styles core Home Assistant UI, Material (MDC) components, and popular custom cards like Bubble Card
• Zero configuration — install it and pick it, no options to tune

Screenshots

Installation

HACS (recommended)

1. In Home Assistant, go to HACS.
2. Click the three-dot menu (top right) → Custom repositories.
3. Add https://github.com/JelleBuning/vane as category Theme.
4. Find Vane in HACS and install it.
5. Go to Settings → System → General and select Vane as your theme (or set it per-user in your profile).

Manual

1. Copy themes/vane.yaml into your Home Assistant config/themes/ directory.
2. Make sure themes: is enabled under frontend: in configuration.yaml:

   frontend:
     themes: !include_dir_merge_named themes

3. Restart Home Assistant (or reload themes) and select Vane as your theme.

Customizing

All colors live in a small set of vn-* variables per mode (dark/light) at the top of themes/vane.yaml. Change a color there and it propagates everywhere it's used — see CLAUDE.md for how the file is structured.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b features/feature-title)
3. Commit your Changes (git commit -m 'Added feature')
4. Push to the Branch (git push origin features/feature-title)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)