Skip to content

HATS 1.0.0 - the first release of the Home Assistant Theme Store

Choose a tag to compare

View all tags
@HomeRiz HomeRiz released this 02 Oct 20:05
· 47 commits to main since this release
1.0.0
b2ab8e3
This commit was signed with the committer’s verified signature.
HomeRiz
SSH Key Fingerprint: jysz+EkxdMJUdeA4iB2F2/0B5qB3fyLRRhqda3YoG5o
Verified
Learn about vigilant mode.

HATS is a Home Assistant app for designing, previewing and installing themes without editing YAML. Open it from your sidebar, pick or build a theme, see it on a real Home Assistant dashboard, and install it with one click.

Highlights

Design

  • Visual theme designer with palettes, SVG patterns, artwork presets, custom CSS, glass and sidebar controls.
  • Background studio: upload, crop, darken and pull a palette from your own picture.

Browse

  • Over 120 themes in the library: 21 original HATS themes, 95 community themes and 7 built-in themes, including a new set for kids with their own pictures.
  • Themes from the same author are grouped into packs. Step through a pack variant by variant with the arrow keys, and carry on into the next pack.
  • Import any public GitHub repository or raw YAML link. A repository with several themes arrives as one pack.

Preview

  • A live preview that runs Home Assistant's own frontend against a built-in demo backend, so you see real cards, dialogs and sidebar styling before installing anything.
  • Light themes are previewed with light colours, and card-mod, Bubble Card and Mushroom Cards styling is applied.

Install

  • One-click install to /config/themes with an automatic theme reload, plus uninstall and batch install.
  • Wallpapers are uploaded for you and referenced from your Home Assistant.
  • The HA Doctor checks for card-mod, Bubble Card and HACS and can fix configuration.yaml for you.

Share

  • Submit your theme to the community as a pull request, using an optional GitHub token that never leaves the app.

Safe by default

  • Reachable only through Home Assistant Ingress, with no host port published.
  • Protection against cross-site requests, path traversal and unsafe theme values, sanitised SVG, and checked image uploads.

Getting started

  1. In Home Assistant go to Settings, Apps, and click Install app to open the App store.
  2. Open the menu in the top right and choose Repositories.
  3. Add https://github.com/HomeRiz/hats.
  4. Find HATS - Home Assistant Theme Store, click Install, turn on Show in sidebar, and start it.
  5. Open HATS. If card-mod is not set up yet, the HA Doctor walks you through it.

Good to know

  • Community themes belong to their authors. Each card credits the author and links to the source repository.
  • A few community themes expect wallpaper pictures in your own /config/www folder (Your Name, Liquid Glass and Waves), so they show no wallpaper until you add them.
  • Runs on amd64 and aarch64.

See the changelog for the full list.

Assets 2
Loading