Home Assistant add-on

Visual configurator that generates and surgically edits the ESPHome YAML for every Xima Domo device, alongside a live mirror of each entity's Home Assistant state.

Features

• Component-centric editor: light, switch, cover, dallas, PZEM, cistern, digital input.
• Surgical YAML editing — preserves your hand-written sections and identity (unique_id) on every save.
• Live entity status pulled from HA every 3 s, with one-click toggle.
• Diff and undo per save; git history of every device file.
• Rename detection with automation-reference search across your HA config.
• DS18B20 address discovery from inside the add-on.
• PZEM multi-meter RS485 support.
• Cistern orchestration with optional flow-based pump protection.
• EN / ES interface (instantly switchable).

Install

1. In Home Assistant: Settings → Add-ons → ⋮ → Repositories.
2. Paste the repository URL: https://github.com/arivelli/xima-domo.
3. Install Xima Domo from the listed add-ons and start it.
4. Open the sidebar panel and add your first device.

Manual install steps for the HAOS local-add-on path live in /docs/addon/install.md.

Under the hood

Front-end: React + TypeScript + Tailwind. Back-end: FastAPI talking to Supervisor for HA state and writing files in /config/esphome/. YAML edits are surgical — the parser tracks every entity's identity through unique_id, so a name change in the UI doesn't silently re-create your HA entity.

See the docs index for the architecture and the deep-dive yaml-surgery.md.