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=3.4.0
    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/latest/download/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=3.4.0
    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. Change the version at the end of the card's reference url in your ui-lovelace.yaml - any new value will do, it is what makes the browser fetch the new file rather than the one it cached.

resources:
  - url: /local/mini-climate-card-bundle.js?v=3.4.0
    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
Functions	every option written as a function, its arguments and what it returns
Tap action	what a tap does, with examples
Secondary info	the line under the name, and its types
Visual editor	which options the built-in UI editor exposes, and which stay YAML-only
Examples	a complete configuration
AI assistants	writing a card with Claude, Cursor or ChatGPT, and what to check in what it writes
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.