Konfiguration

Modell

Ein HA-Profil enthält das vollständige Dashboard. Der Geräte-Override ist ein RFC-7396-Merge-Patch: Objekte werden rekursiv verbunden, Arrays ersetzt und null löscht einen Wert. Entwurf, Validierung und Veröffentlichung sind getrennt; zwanzig unveränderliche Revisionen bleiben erhalten. Fehlende Provider blockieren, vorübergehend fehlende Entities warnen.

Beispiel

{
  "schema_version": 1,
  "theme": {"background_color": "#121212", "primary_color": "#2d2d2d", "accent_color": "#80c100", "text_color": "#ffffff", "padding": 8, "gap": 6},
  "app": {"language": "de", "keep_screen_on": true, "screensaver": {"enabled": true, "idle_seconds": 120, "provider_id": "family-photos"}},
  "voice_assistant": {"enabled": true, "push_to_talk": true, "tts_output": "ha_stream"},
  "tabs": [
    {
      "id": "home",
      "title": "Zuhause",
      "columns": 2,
      "widgets": [{"id": "light", "type": "light", "entity_id": "light.wohnzimmer"}]
    }
  ]
}

Themes sind Objekte für Farben, Abstände und Typografie; light und dark sind keine Ersatzkonfiguration. Tabs besitzen stabile IDs, Titel, Spalten, Badges und Widgets. Widgets akzeptieren Rasterposition, colspan, rowspan, Theme-Override und Bedingungen nach HA-State. Provider werden nur über provider_id oder connection_id referenziert; Secrets im Dashboard werden abgewiesen. Bei gekoppelten Geräten ist HA die einzige Quelle für Dashboard- und Gerätefunktionen. Nur die zum Verbindungsaufbau erforderlichen lokalen Felder für HA-URL, Routing-Override und Zertifikatsausnahme bleiben editierbar.

Editor und Vorschau

JSON ist die Standardansicht mit Syntaxhervorhebung, Zeilennummern, Validierung sowie Profil-, Override- und effektiver Ansicht. Der visuelle Editor bearbeitet Theme, Tabs, Raster und native Widgets und bewahrt unbekannte Advanced-Blöcke unverändert. Die Geräteauswahl verwendet gemeldete Pixel, Activity-Fläche, Orientierung, Dichte, Font-Scale und Insets. Die vergrößerbare Vorschau skaliert das feste Gerätelayout proportional und verwendet neutrale Platzhalter für nicht ladbare Medien. HA-States sind echt; die Android-Darstellung bleibt maßgeblich.

Offlinebetrieb

Eine gültige neue Revision wird in privaten Preferences gespeichert und erst nach erfolgreichem UI-Swap bestätigt. Bei Fehlern bleibt die vorherige Version aktiv. Offline werden HA-Controls als nicht verfügbar angezeigt; Benachrichtigungen und Aktionen werden nicht nachträglich abgespielt.