Skip to main content

Themes

A template to use as a reference is home-assistant-community-themes/template

This is for the frontend integration in Home Assistant

Requirements​

For a theme repository to be valid these are the requirements:

Repository structure​

  • The theme configuration file are located here ROOT_OF_THE_REPO/themes/SCRIPT_NAME.yaml
  • There is only one theme configuration file (one directory under ROOT_OF_THE_REPO/themes/) per repository (if you have more, only the first one will be managed.)

OK example:​

themes/awesome.yaml
info.md
README.md

Not OK example:​

awesome.py
info.md
README.md

GitHub releases (optional)​

If there are releases​

When downloading/upgrading it will scan the content in the latest release.

If there are multiple releases in the repository the user have some options to download a specific version. The choices will be the last 5 releases and the default branch.

If there are no releases​

It will scan files in the branch marked as default.