Home Assistant Config Flow & Discovery

Use this skill when adding or adjusting setup flows, discovery handlers, options flows, or reauth for this integration.

When to Use

• Creating or refining config_flow.py
• Handling discovery sources (user, dhcp, zeroconf, integration discovery)
• Adding/updating options flow or reauth steps
• Ensuring duplicate prevention and IP-change handling are correct

Core Principles

• UI-first: No new YAML; all setup in the UI.
• Async-only: All I/O must be awaited; use executor only for blocking library work.
• One device, one entry: Abort duplicates; update existing entries when discovery reports a new host/IP.
• Stable identifiers: Use BLE-MAC (or WiFi MAC) for unique IDs; never pivot unique IDs on IP.
• Selectors > raw text: Prefer HA selectors for better UX and validation.