# Mini Humidifier Card

> A minimalistic yet customizable humidifier card for the Home Assistant Lovelace UI.

The card is configured in YAML rather than coded, and several of its options are
JavaScript written as text - arrow functions the card compiles and calls with a
context of its own. Three things are worth knowing before writing one: every option
the card has is a row in the Configuration table; `model:` chooses the defaults the
card starts from, and a model the card does not know warns to the console and falls
back to the default one rather than refusing; and a key the card does not know is
handed to the templates rather than rejected, so a wrong option does nothing at all
instead of complaining.

## Documentation

- [Home](https://artem-sedykh.github.io/mini-humidifier/): What the card is, how to install it with HACS, and how to update it.
- [Getting started](https://artem-sedykh.github.io/mini-humidifier/getting-started/): A path from a card that just works to one that is yours, a block at a time.
- [Configuration](https://artem-sedykh.github.io/mini-humidifier/configuration/): Every option the card accepts, in one table, with the type and default of each - plus which of them the visual editor reaches. An option that is not here does not exist.
- [Models](https://artem-sedykh.github.io/mini-humidifier/models/): The devices the card ships defaults for: what `model:` picks, and what each preset fills in before your YAML is merged over it.
- [A device with no preset](https://artem-sedykh.github.io/mini-humidifier/custom-device/): Configuring a device the card has never heard of: what to read off it first, which base to start from, and the contract the card speaks - the page to hand an assistant that is helping with a card.
- [Controls](https://artem-sedykh.github.io/mini-humidifier/controls/): The parts of the card a user touches - the target humidity slider, the power switch, the state - and the line of text under the entity name.
- [Indicators](https://artem-sedykh.github.io/mini-humidifier/indicators/): The read-only values under the entity name, and what each one can read.
- [Buttons](https://artem-sedykh.github.io/mini-humidifier/buttons/): Buttons and dropdowns in the bottom panel: what they call, how they are ordered, and when they are hidden or disabled.
- [Examples](https://artem-sedykh.github.io/mini-humidifier/examples/): Complete cards to copy, and the `tap_action` snippets.
- [AI assistants](https://artem-sedykh.github.io/mini-humidifier/ai-assistants/): Writing a card configuration with an AI assistant: how to hand it this documentation, and the four things about this card an assistant gets wrong.
- [Development](https://artem-sedykh.github.io/mini-humidifier/development/): Building the card from source, running the checks, and how a change reaches master.

## Everything at once

- [Mini Humidifier Card, whole](https://artem-sedykh.github.io/mini-humidifier/llms-full.txt): every page above, concatenated, for grounding an answer in one fetch.