Mini Climate Card

A minimalistic yet customizable climate card for Home Assistant Lovelace UI.
Please ⭐️ this repo if you find it useful

Notice

v2 is only compatible from version 2022.11 onwards

Install

This card is available in HACS (Home Assistant Community Store)

Simple install

1. Download and copy mini-climate-card-bundle.js from the latest release into your config/www directory.

2. Add a reference to mini-climate-card-bundle.js inside your ui-lovelace.yaml.

resources:
  - url: /local/mini-climate-card-bundle.js?v=2.21
    type: module

CLI install

1. Move into your config/www directory

2. Grab mini-climate-card-bundle.js

$ wget https://github.com/artem-sedykh/mini-climate-card/releases/download/v2.2.1/mini-climate-card-bundle.js

1. Add a reference to mini-climate-card-bundle.js inside your ui-lovelace.yaml.

resources:
  - url: /local/mini-climate-card-bundle.js?v=2.2.1
    type: module

Updating

1. Find your mini-climate-card-bundle.js file in config/www or wherever you ended up storing it.

2. Replace the local file with the latest one attached in the latest release.

3. Add the new version number to the end of the cards reference url in your ui-lovelace.yaml like below.

resources:
  - url: /local/mini-climate-card-bundle.js?v=2.2.1
    type: module

You may need to empty the browsers cache if you have problems loading the updated card.

Documentation

The full documentation is at artem-sedykh.github.io/mini-climate-card, and the same pages are in docs/.

Configuration	every card option, the toggle, and the theme variables
Controls	temperature, target temperature, hvac mode, fan mode
Indicators	the read-only values under the entity name
Buttons	buttons and dropdowns of your own
Tap action	what a tap does, with examples
Secondary info	the line under the name, and its types
Examples	a complete configuration
Development	building the card, and what to do when it errors

Links here are absolute on purpose: HACS renders this file outside GitHub and resolves a relative path against a URL of its own, where it 404s.

Contributing

CONTRIBUTING.md has what to know before opening a pull request, and AGENTS.md is the long version: how the card is put together and what breaks it.

License

This project is under the MIT license.