Icons and logos for a Home Assistant custom integration — where they live since 2026.3, the filenames and sizes Home Assistant recognises, rendering them from SVG, and the librsvg quirks that produce visible seams. Use when adding or changing an integration's…
The house style for a Home Assistant integration README and its release notes — the layout, the badges, the voice, and what belongs above the fold. Use when writing or rewriting README.md, adding screenshots, or drafting release notes for one of these…
Turn this template into a real Home Assistant integration. Use immediately after creating a repository from ha-integration-template, or when asked to "start a new integration", "bootstrap this", or "set up the scaffold". Covers running scripts/bootstrap,…
Cut a new tagged release of this Home Assistant integration. Use when asked to "release", "cut a release", "ship a version", or publish a new vX.Y.Z. Covers the version scheme, the fact that manifest.json is bumped automatically by CI and never by hand, the…
House conventions for Home Assistant custom integration code — config entry runtime data, unique IDs, entity naming and translation keys, coordinator and availability patterns, config flow rules, services, and the deprecated APIs to avoid. Read before writing…
Getting a custom integration installable — the HACS custom-repository route, the requirements the HACS action checks, submitting to the HACS default list, and the route to upstreaming into Home Assistant core. Use when the HACS CI job fails, when asked how…
How the test suite for these Home Assistant integrations is set up and what is worth testing. Use when adding or fixing tests, when a test needs a Home Assistant fixture, when the suite fails to import, or when deciding whether something needs a test at all.