Domus UI
A new Home Assistant experience, designed for desktop, tablet, and mobile.
A responsive dashboard, visual builder, and advanced controls in one consistent, premium interface.
Your home, one experience
| Visual builder | Truly responsive layouts | Home Assistant native |
|---|---|---|
| Cards, stacks, drag and drop, sizing, and configuration without writing YAML. | Dedicated desktop, tablet, and mobile grids, synchronized across the same home. | HACS installation, HA sessions, permissions, and commands authorized by the server. |
| Explicit security | Consistent experience | Diagnostics and recovery |
|---|---|---|
| Isolated Demo mode, secrets excluded from layouts, and protected sensitive actions. | Light and dark themes, glass surfaces, and touch-friendly controls. | Layout history, sanitized backups, rollback, and privacy-safe reports. |
Why Domus UI
- One home layout shared and synchronized across devices.
- Authoritative shared reset: an old browser cache cannot accidentally restore a deleted layout.
- Separate desktop, tablet, and mobile grids with drag and drop and undo/redo.
- Responsive cards and contextual panels for the main Home Assistant entity domains.
- Guided onboarding, isolated Demo mode, and connection through the authenticated Home Assistant session.
- A visual builder with catalog, stacks, breakpoint-aware sizing, and related-device configuration.
- Light and dark themes, glass surfaces, and touch-friendly controls.
- Centralized permissions: Home Assistant remains the authority for identity, roles, and commands.
Install with HACS
HACS is the only distributed installation method for the public beta. The future official app will become the second supported channel.
- Install and configure HACS in Home Assistant.
- Open the link above, or add
Mattia2399/DomusUIas a custom Integration repository. - Download Domus UI and restart Home Assistant.
- Go to Settings -> Devices & services -> Add integration.
- Search for Domus UI, confirm, and open the new sidebar entry.
No configuration.yaml changes, manual tokens, or /www copies are required. See the complete installation guide for updates, rollback, and troubleshooting.
A HACS release must contain the
domusos.zipasset. Git tags without a published GitHub Release cannot be installed by HACS.
Feature status
| Area | Beta status | Notes |
|---|---|---|
| Home and Builder | Operational | Shared layout, Edit Mode, catalog, stacks, versions, and recovery |
| Rooms | Operational | Floors, rooms, devices, and controls authorized by HA |
| Security | Operational | Alarm, cameras, and sensors; not a replacement for a certified security system |
| Consumption | Operational | Summaries based on data exposed by HA entities |
| Profile and Settings | Operational | Personal preferences separated from home-wide configuration |
| App Gallery | Partial | Irrigation is in beta; Utility Room and Pool & Spa are in development |
| Automations | Coming later | The incomplete interface is not exposed as a usable feature |
| Calendar, Map, and Lists | Planned | Scheduled after the first beta cycle |
Detailed status and verified hardware limitations are documented in Feature status.
Irrigation: overview, configuration, calendar, consumption, and supervised commands are available. The server-side engine with watchdog and restart recovery is planned for the next development cycle. Until then, do not use beta scheduling as the only safeguard for unattended irrigation.
Available cards
Sensor, Light, Switch, Climate, Alarm, Lock, Cover, Camera, Media Player, Vacuum, and Members. Cards adapt their content and layout to the available size. Some capabilities depend on the attributes and services actually exposed by the device's Home Assistant integration.
Security and privacy
- Tokens, PINs, Alarm/Lock codes, and passkeys are excluded from layouts, backups, and synchronization.
- Demo mode and the real home use separate storage spaces.
- Structural changes are restricted to Owner/Admin users and fail closed.
- Home Assistant still performs final server-side authorization for commands.
- WebAuthn device confirmation is a local safeguard, not a certified server-side second factor.
- Domus UI beta is not a certified alarm, security, or safety system.
Read Security and privacy and the beta security checklist before using Domus UI in a real home.
Development
Node.js 22.22.0 or newer is required.
npm ci
npm run dev
Run the complete verification suite before a release:
npm run release:gate
npm run release:package
Packaging creates both the diagnostic web-app archive and release-artifacts/domusos.zip, ready for a HACS GitHub Release.
Comments