Skip to content

About

Reusable Home Assistant dashboard templates, shared settings and hash-based Bubble popups.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Library Card for Home Assistant

Library Card

HACS Release Maintainer Donate

Deutsch | English

Deutsch

1. Projekt und Kurzbeschreibung

Library Card verwaltet wiederverwendbare Dashboard-Karten zentral in Home Assistant. v2.0.0 enthält den breiten Editor für zentrale Vorlagen und lokale Karten sowie die automatische Vorbereitung anpassbarer und leerer Vorlagen. Karten bleiben mit ihrer Vorlage verknüpft; örtliche Ausnahmen ergänzen diese Vorlage.

2. Projektzweck und Funktionsumfang

Zentrale Änderungen erreichen alle verknüpften Verwendungen. Entitäten, Variablen, Layout, Styles, card-mod und Popup-Optionen können örtlich abweichen. Gemeinsame Einstellungen und Personenfarben bleiben zentral. Die Oberfläche trennt „Vorlagen einsetzen“ und „Konfiguration“ und verwendet native HA-Bedienelemente.

Unterstützt werden Originaleditoren, YAML-Import, JSON-Import/Export, benannte Button-Card-Templates mit statischer Vererbung, Kategorien/Suche, definierte Eingabefelder, Vorlagenschutz, bis zu zehn vorherige Speicherstände, gezielte Rücknahme und Änderungsvorschau. Verwendungen lassen sich ansehen, bearbeiten, vergleichen und duplizieren; die Übersicht nennt Fundstellen und fehlende Entitäten.

Erstellung und Bearbeitung öffnen ein breites Fenster mit Konfiguration links und Vorschau rechts. Die fünf Reiter Karte, Eingabefelder, Vorlage, Erweitert und Popup & Verwendung ordnen zentrale und lokale Bearbeitung. Karte bearbeiten öffnet die lokale Bearbeitung ausschließlich per Klick; Auswahl und Verschieben öffnen kein Fenster. Einsetzen übernimmt neue Karten nur in den vorherigen HA-Karteneditor und schließt das breite Fenster. Der HA-Karteneditor mit seiner vorherigen Auswahl bleibt offen; erst dessen reguläres Speichern schreibt das Dashboard. Speichern im breiten Fenster sichert zentrale Vorlagen, vorhandene Karten und Verwendungen aus der Nutzungsübersicht; Abbrechen verwirft nur den Fensterentwurf. Das Kategorie-Dropdown bietet vorhandene Namen und Neue Kategorie … mit freier Namenseingabe; Ohne Kategorie entfernt die Zuordnung. Die kompakte Verwaltung behält Übersicht und allgemeine Bibliothekseinstellungen. Jede Seite und jeder Editorreiter bietet einen Hilfe-Button: Er öffnet die passende Seitenhilfe. Kategorien und eine globale Suche erschließen den gesamten Hilfekatalog. Direkt an den Feldern bleiben nur ausgewählte kurze Hinweise; zusätzliche Info-Buttons und Tooltips entfallen. Bedienhilfe.

Beim Erstellen zuerst Darstellung (Karte/Popup) und Verwendung wählen: Fertige Karte übernimmt unverändert ohne automatische Felder. Anpassbare Vorlage behält Zuordnungen als Vorgaben, Leere Vorlage leert Entitäten, Icons, Namen und Navigationsziele. Vorhandene Sensorgrenzen und Farben bleiben änderbar. Die Automatik ergänzt nur statisch unterstützte bereits vorhandene Sensorgrenzen und zugehörige Farben zur bisherigen Erkennung der Zuordnungen. Gleich benannte Bereiche werden gemeinsam aufklappbar angezeigt, etwa Raumklima. Darin hat jeder Sensor sein zugeordnetes Entitätsfeld und einen eigenen aufklappbaren Unterbereich Einstellungen mit den bereits zugeordneten Grenzen, Farben und weiteren erkannten Einstellungen. Gemeinsame Farben bleiben unter Raumklima – Farben separat. Diese Ordnung gilt zentral und lokal; sie erzeugt keine zusätzlichen Eingaben. Leere Grenzen deaktivieren genau ihre Grenze; 0, negative Zahlen und numerischer Text bleiben gültig. Vergleiche, Rot-Vorrang und Einheiten der Karte bleiben erhalten. Weitere eigene Felder und die Fundstellenprüfung stehen unter Erweitert → Weitere Eingabefelder. Bereits vorbereitete leere/anpassbare Vorlagen aktualisieren ihre Felder nach zentralen YAML-/Originaleditor- und Feldbaumänderungen; eigene Beschriftungen, bewusst leere Bereiche/Hinweise und manuelle Typen bleiben erhalten. Zentral gebundene Pfade sind ausgenommen. Überzählige automatisch erzeugte editor-07-Felder werden beim Bearbeiten bereinigt, ohne Karteninhalt oder lokale Werte zu verlieren. Die Autorenanleitung erklärt die unterstützten Sensorgrenzen, ausdrückliche Autorenfelder und Erkennungsgrenzen.

Der Button-Card-Umwandler übernimmt vorhandene Kartenaufrufe in eine ausgewählte, bestehende Bibliotheksvorlage. Das Ergebnis lässt sich im normalen HA-Karteneditor speichern oder als vollständiges Referenz-YAML kopieren. Dabei wird keine weitere Bibliotheksvorlage erstellt.

3. Systeme, Geräte und Voraussetzungen

Home Assistant 2024.7.0 oder neuer. Native Karten, separat installierte Custom Cards sowie horizontal-stack-, vertical-stack- und grid-Konfigurationen sind verwendbar. Kopf-/Fußzeilen dürfen ein äußeres card: und numerisches max_width: enthalten. Genutzte Custom Cards und card-mod müssen separat installiert und geladen sein.

Hash-Popups benötigen originale Bubble Card ab 3.2.0 mit eigenständigem Popup-Format. Die Browserprüfungen verwenden Originaldateien von 3.2.0 und 3.4.2 sowie Button Card 7.0.1. Die Fremdkarten werden nicht mitgeliefert. Andere Karten, Versionen, Themes und Mobilgeräte benötigen eigene Prüfungen. Home Assistant unterstützt das vorhandene lokale Logo ab 2026.3; die Store-Anzeige hängt auch von Index und Cache ab.

4. Installation

  1. In HACS nach Library Card suchen und die Integration herunterladen. Das Repository ist im HACS-Katalog aufgenommen; ein benutzerdefiniertes Repository ist dafür nicht erforderlich.
  2. Home Assistant neu starten. Unter Einstellungen → Geräte & Dienste → Integration hinzufügen Library Card einrichten.
  3. Unter Einstellungen → Dashboards → Ressourcen /card_library/card-library.js?v=2.0.0 als JavaScript-Modul eintragen. Einen vorhandenen Eintrag aktualisieren; keine doppelte Ressource anlegen.
  4. Den Browser vollständig neu laden. Im Dashboard die Kartenbibliothek (custom:library-manager) zur Verwaltung und Vorlagenkarte (custom:library-card) zur Verwendung auswählen.

Alternativ das Installationsarchiv library-card-v2.0.0.zip aus dem Release entpacken und den enthaltenen Ordner custom_components/card_library vollständig nach /config/custom_components/card_library kopieren. Danach dieselben Neustart-, Einrichtungs- und Ressourcenschritte ausführen. Vor einem Austausch vorhandener Dateien die Bibliothek als JSON exportieren, die verwendeten Dashboards und den bisherigen Integrationsordner sichern.

5. Einrichtung und Authentifizierung

Es werden die vorhandene HA-Anmeldung und deren Berechtigungen verwendet; zusätzliche Zugangsdaten sind nicht erforderlich. Schreibende Verwaltungsfunktionen benötigen Administratorrechte. Eine Verwaltungskarte im Dashboard dient der zentralen Pflege.

6. Konfiguration und Optionen

Vorlagen mit dem Originaleditor erstellen oder vorhandenes Karten-YAML übernehmen. Ganze Kartenbäume bleiben erhalten. Gruppen und Personenfarben können an Felder oder vollständige Bereiche gebunden werden. Eingabefelder unterstützen Entität, Icon, Farbe, Text, Zahl, Schalter und Auswahl sowie Entitätsdomänen. Im manuellen Feldeditor unterscheidet Feldverhalten zwischen Inhalt / Zuordnung und Einstellung mit Vorgabe. Der zentrale Vorgabewert einer vorbereiteten Einstellung wird mit der Vorlage gespeichert. Automatisch vorbereitete Eingaben sind immer optional. Bestehende oder manuelle Pflichtfelder bleiben unterstützt. Geschützte Vorlagen müssen separat entsperrt und gespeichert werden.

Popup laden: je Vorlage „Beim Öffnen laden“ (Standard) oder „Im Hintergrund vorladen und bereithalten“. Gespeicherte Hash-Varianten können den Vorlagenwert übernehmen oder ausdrücklich vorladen bzw. erst beim Öffnen laden. Intern sind dies template.preload und optional popup_links[].preload; diese Bibliotheksmetadaten sind keine Bubble-Optionen. Vorladen gilt je Browser-Sitzung, benötigt zusätzlichen Speicher und hält die ausgewählten Originalkarten außerhalb des Dashboard-Rasters verbunden. Unveränderte Varianten werden weiterverwendet; Änderungen und ungültige Pflichtwerte werden berücksichtigt.

YAML anzeigen / kopieren: unter „Vorlagenaktionen“ die zentrale Vorlage oder eine gespeicherte Hash-Variante auswählen. Die vollständige Momentaufnahme enthält aktuelle gemeinsame Werte, örtliche Ausnahmen der gewählten Variante, Unterkarten, Popup-Optionen und fremde Konfigurationsfelder. Ein Textfeld ermöglicht manuelles Kopieren, wenn die Zwischenablage nicht verfügbar ist. Kopieren ändert keine Verknüpfung. Zentrale Kopf-/Fußzeilen werden wieder als äußeres card:/max_width: ausgegeben; innerhalb eines Popups kann der vorhandene Container-Adapter zur Erhaltung der Breite nötig bleiben.

Vorhandene Button Card übernehmen: genau einen festen template-Namen, auch als Liste mit einem Eintrag, oder eine vollständige einzelne Button Card ohne template einfügen. Die im Editor ausgewählte Bibliotheksvorlage bestimmt das Ziel. Explizit eingefügte Variablen bleiben lokale Werte, auch wenn sie derzeit mit der Vorlage übereinstimmen. Fehlende Felder erben weiter; vorhandene lokale Ausnahmen bleiben erhalten, soweit die Eingabe sie nicht ausdrücklich ersetzt. HA-Platzierungsfelder bleiben außen an der Referenzkarte. Details: Button-Card-Vorlagen.

7. Verwendung

„Diese Vorlage verwenden“ erstellt eine Bibliotheksreferenz. Lokale Entitäten, Variablen, Designfelder, CSS und card-mod können anschließend angepasst werden. YAML zum Einbauen sowie Buttons erzeugt die Oberfläche für die ausgewählte Vorlage.

Die Übernahme läuft so ab:

  1. Im HA-Dashboard eine neue Karte anlegen und Vorlagenkarte wählen.
  2. Die gewünschte vorhandene Button-Card-Vorlage auswählen.
  3. „Vorhandene Button Card übernehmen“ öffnen und unter „Bisherige Kartenkonfiguration (YAML)“ den alten Kartenaufruf einfügen.
  4. „Für diese Karte übernehmen“ drücken und die Werte prüfen.
  5. Karte bearbeiten öffnen. Für eine neue Karte mit Einsetzen die Werte in den vorherigen HA-Karteneditor übernehmen. Das breite Fenster schließt sich; im HA-Karteneditor kann die Karte weiter geprüft und erst mit dessen regulärem Speichern im Dashboard gesichert werden. Bei einer vorhandenen Karte speichert Speichern im breiten Fenster weiterhin direkt. Alternativ „Neuen YAML-Code kopieren“ verwenden und den vollständigen Code an der gewünschten Dashboardstelle einsetzen.

Der Umwandler prüft das YAML über den vorhandenen Parser und ändert nur die lokale Konfiguration im geöffneten Karteneditor. Er speichert weder die zentrale Bibliothek noch das Dashboard direkt; das Dashboard wird erst durch den normalen HA-Speichervorgang geändert.

Für ein Popup genügt ein Navigationsbutton zum gespeicherten Hash. Es sind weder eine zusätzliche Popup-Karte noch ein Platzhalter im Raster erforderlich. Ein eigenständiges Bubble-Popup mit cards:, ein klassischer vertical-stack mit Popup-Kopf oder eine normale Karte können als Inhalt dienen. Mehrere Hash-Varianten verweisen auf dieselbe Vorlage; alle Buttons mit demselben Hash teilen dieselbe gespeicherte Variante. Direkte fire-dom-event-Aufrufe mit card_library bleiben möglich.

Beim Bearbeiten von Bubble-Unterkarten verwendet die Bibliothek einen eigenen nativen HA-Dialog mit eigenem Speicheraufruf. Änderungen werden an den eingebetteten Originaleditor zurückgegeben und anschließend nach dem bestehenden Ablauf gespeichert. Die Dashboardposition der Verwaltungskarte ist dadurch kein Speicherziel der Popup-Unterkarte.

UI-Dashboards werden über Lovelace-Schnittstellen mit Fingerprint- und Revisionsprüfung geändert. Für YAML-Dashboards wird die Konfiguration zum manuellen Übernehmen ausgegeben. Die Nutzungsübersicht zählt gespeicherte Verknüpfungen und statisch erkennbare Popup-Aufrufe; sie ist keine Klickstatistik.

8. Aktualisierung und Migration

Über HACS aktualisieren oder das vollständige Installationsarchiv übernehmen. Home Assistant neu starten, die bestehende Ressource auf /card_library/card-library.js?v=2.0.0 setzen und den Browser vollständig neu laden. Dies gilt auch beim Wechsel vom lokalen Test editor-09: den bisherigen local-Zusatz entfernen. Domain und Bibliotheksspeicher bleiben card_library; Integrationseinträge und .storage behalten.

Vor dem Update Bibliotheks-JSON, verwendete Dashboards und Integrationsdateien sichern. Vorhandene v1.1.0-Vorlagen benötigen keinen manuellen Umbau. Erst Vorlage automatisch vorbereiten erzeugt ihre neuen Eingabefelder. Vorbereitete Vorlagen aus editor-09 können weiterverwendet werden. Ältere Versionen verstehen die neuen Vorbereitungs- und Feldmetadaten nicht vollständig; vor einer Rückkehr kompatible Bibliotheks- und Dashboarddaten wiederherstellen. Das Zurückkopieren von Programmdateien nimmt gespeicherte Datenänderungen nicht zurück.

Interne Aktualisierungen laufen jetzt über den Dispatcher, wie im HACS-Review empfohlen. Die WebSocket-Befehle und Nutzdaten bleiben erhalten; das frühere Eventbus-Ereignis card_library_updated wird nicht mehr gesendet. Es gibt keine zusätzliche HA-Anmeldung oder manuelle Speichermigration.

Entwicklerablauf und fortsetzbares vollständiges Aktualisierungsskript: Veröffentlichung.

9. Einschränkungen und Fehlerbehebung

Nicht jede Fremdkarte besitzt einen grafischen Editor. Vorladen garantiert keine abgeschlossenen Netzabfragen und kann sichtbarkeitsabhängige Initialisierung einer Unterkarte nicht erzwingen. Dynamische JavaScript-/Jinja-Aufrufe lassen sich nicht vollständig statisch erfassen. Die automatische Vorbereitung wandelt nur eindeutige unterstützte Fundstellen um; Hinweise, erzeugte Felder und Ausblendung in der Vorschau sowie echten Verwendung prüfen. Die Bubble-Kompatibilitätsadapter sind an vorhandene Fähigkeiten gebunden; bei inkompatiblen Versionen gibt es eine Meldung und Vorladen fällt auf Laden beim Öffnen zurück. Ein nicht sicher isolierbarer Unterkarteneditor wird gesperrt.

Der Umwandler weist mehrere oder dynamische template-Verweise sowie Konflikte mit zentralen Bindungen zurück. Das gilt auch für gebundene Platzierungsfelder. Lokal angepasste Listen und extra_styles werden als örtlicher Stand gespeichert; spätere zentrale Änderungen an genau diesen Feldern kommen dort nicht an. Bei zentralen und lokalen extra_styles-Beiträgen mit JavaScript wird die Übernahme abgewiesen, da getrennte Auswertungen nicht verlustfrei kombiniert werden können. Verschachtelte, noch vorhandene Template-Verweise benötigen ihre Definitionen weiterhin im Dashboard. Hinweise in der Oberfläche erläutern solche Grenzen.

Bei alten Ansichten Ressourcenversion und Browsercache prüfen. Bei fehlenden Karten zuerst Fremdressourcen und Entitäten prüfen. Der Teststand verwendet teilweise nachgebildete HA-Schnittstellen; ein vollständiger Test auf einer realen HA-Installation mit allen Themes und Mobilgeräten ist nicht erfolgt.

10. Entwicklung und Tests

Python ab 3.12, Node.js ab 22 und requirements-dev.txt verwenden. npm test, python3 -B -m unittest discover -s tests, python3 tests/check_websocket_schemas.py, python3 scripts/check_release.py --configured und python3 scripts/build_release.py prüfen Funktionen, WebSocket-Schemas, Metadaten und das Installationsarchiv. Der öffentliche Build enthält alle 21 Frontend-Module ohne lokale Kennung.

Bestanden: 1079 JavaScript- und 239 Python-Prüfungen sowie 69 verschiedene Browserfälle. Prüfumfang, Browseraufrufe und tatsächliche Grenzen stehen in DEVELOPMENT.md. HACS, Hassfest und Tests müssen für genau den Release-Commit erfolgreich sein, bevor Tag und Release veröffentlicht werden. Der Nutzer hat den lokalen Editorstand auf seiner HA-Instanz erprobt; die automatisierten Browserprüfungen verwenden teilweise nachgebildete HA-Schnittstellen und ersetzen keine umfassende Live-Prüfung aller Fremdkarten, Themes und Geräte.

11. Versionshistorie

CHANGELOG.md und GitHub-Releases. Die Einträge beschreiben veröffentlichte Stände; lokale Prüfrunden erhalten keine eigene Version.

12. Unterstützung, Mitwirkung, Danksagung und Lizenz

Fehler mit Versionen und nachvollziehbarem Ablauf als Issue melden. Beiträge sind per Pull Request willkommen; siehe CONTRIBUTING.md. Danke an Home Assistant, HACS und die Entwickler der unterstützten Originalkarten, insbesondere Bubble Card. Unterstützung ist über PayPal möglich. Lizenz: MIT.

English

1. Project and short description

Library Card centrally manages reusable dashboard cards in Home Assistant. v2.0.0 provides the wide editor for central templates and local cards, plus automatic preparation of adjustable and empty templates. Cards remain linked to their template; local exceptions supplement that template.

2. Purpose and features

Central changes reach every linked use. Entities, variables, layout, styles, card-mod and popup options may differ locally. Shared settings and person colors remain central. The interface separates insertion from configuration and uses native HA controls.

Features include original card editors, YAML input, JSON import/export, named Button Card templates with static inheritance, categories/search, defined inputs, template protection, up to ten previous saved states, individual restoration and change previews. Uses can be inspected, edited, compared and duplicated; the overview shows locations and missing entities.

Creation and editing open a wide window with configuration on the left and preview on the right. The five Karte, Eingabefelder, Vorlage, Erweitert and Popup & Verwendung tabs organise central and local editing. Karte bearbeiten (Edit card) opens local editing only after a click; selection and moving cards do not open a window. Einsetzen (Insert) applies new cards only to the previous HA card editor and closes the wide window. The HA editor and its previous selection stay open; only its regular Speichern (Save) writes the dashboard. Save in the wide window stores central templates, existing card changes and uses opened from the usage overview; Cancel discards only the window draft. The category dropdown lists existing names and Neue Kategorie … for free-text entry; Ohne Kategorie removes the assignment. The compact manager keeps the overview and general library settings. Each page and editor tab has one Hilfe (Help) button that opens its matching page help. Categories and a global search provide access to the complete help catalogue. Only selected brief hints remain next to fields; additional info buttons and tooltips are removed. Editor help.

Creation first asks for Darstellung (card/popup) and Verwendung (usage): Fertige Karte imports unchanged without automatic inputs. Anpassbare Vorlage retains assignments as defaults; Leere Vorlage clears entities, icons, names and navigation targets. Existing sensor limits and colors remain editable. Automatic preparation adds only statically supported existing sensor limits and associated colors to the previous assignment detection. Inputs with the same Bereich (group) share a collapsible section, such as Raumklima. Each sensor within it has its associated entity input and a separate collapsible Einstellungen (Settings) subsection containing already associated limits, colors and other detected settings. Shared colors remain separate under Raumklima – Farben. This structure applies centrally and locally; it creates no additional inputs. Empty limits disable their specific limit; 0, negative numbers and numeric text remain valid. Card comparisons, red priority and units are preserved. Additional custom inputs and occurrence review are under Erweitert → Weitere Eingabefelder. Prepared empty/adjustable templates update inputs after central YAML/original-editor and field-tree changes while retaining custom labels, intentionally empty groups/hints and manual types. Centrally bound paths are excluded. Excess automatically generated editor-07 inputs are cleaned up when editing without losing card content or local values. The authoring guide explains supported sensor limits, explicit author fields and detection boundaries.

The Button Card converter maps existing card calls to a selected, existing library template. Save the result through the normal HA card editor or copy the complete reference YAML. No additional library template is created.

3. Systems, devices and prerequisites

Home Assistant 2024.7.0 or later. Native cards, separately installed custom cards and horizontal-stack, vertical-stack and grid configurations are supported. Header/footer envelopes may contain card: and numeric max_width:. Used custom cards and card-mod must be installed and loaded separately.

Hash popups require original Bubble Card 3.2.0 or later with standalone popup format. Browser checks use original 3.2.0 and 3.4.2 bundles and Button Card 7.0.1. These cards are not bundled. Other cards, versions, themes and mobile devices need separate testing. Home Assistant supports the existing local logo from 2026.3; store display also depends on its index and cache.

4. Installation

  1. Search HACS for Library Card and download the integration. The repository is included in the HACS catalogue; a custom repository entry is not required.
  2. Restart Home Assistant. Open Settings → Devices & services → Add integration and configure Library Card.
  3. Under Settings → Dashboards → Resources, register /card_library/card-library.js?v=2.0.0 as a JavaScript module. Update an existing entry instead of adding a duplicate.
  4. Fully reload the browser. Add Kartenbibliothek (custom:library-manager) for administration and Vorlagenkarte (custom:library-card) for using a template.

Alternatively, extract library-card-v2.0.0.zip from the release and copy its complete custom_components/card_library folder to /config/custom_components/card_library. Then perform the same restart, setup and resource steps. Before replacing existing files, export library JSON and back up used dashboards and the existing integration folder.

5. Setup and authentication

The integration uses the existing HA login and permissions; no additional credentials are required. Administrative writes require administrator rights. A manager card on the dashboard provides central management.

6. Configuration and options

Create templates with their original editor or import existing card YAML. Complete card trees are preserved. Bind groups and person colors to individual fields or whole sections. Inputs support entity, icon, color, text, number, boolean and selection, plus entity domains. In the manual field editor, Feldverhalten distinguishes Inhalt / Zuordnung (Content/assignment) from Einstellung mit Vorgabe (Setting with default). A prepared setting’s central Vorgabewert is saved with the template. Automatically prepared inputs are always optional. Existing or manual required fields remain supported. Protected templates must first be unlocked and saved separately.

Popup loading: choose loading when opened (default) or background preload and retention per template. Saved hash variants can inherit this choice or explicitly enable or disable preloading. Internally these are template.preload and optional popup_links[].preload; they are library metadata, not Bubble options. Preloading is per browser session, consumes additional memory and keeps selected original cards connected outside the dashboard grid. Unchanged variants are reused; changes and invalid required inputs are respected.

Show / copy YAML: under template actions, choose the central template or a saved hash variant. The complete snapshot contains current shared values, that variant's local exceptions, child cards, popup options and third-party configuration fields. A text field permits manual copying when clipboard access is unavailable. Copying does not change links. Central header/footer exports restore the outer card:/max_width: structure; popup content may retain the existing container adapter to preserve width.

Import an existing Button Card: paste exactly one fixed template name, including a one-entry list, or a complete individual Button Card without template. The library template selected in the editor determines the target. Explicitly supplied variables remain local values even when currently equal to the template. Missing fields keep inheriting; existing local exceptions remain unless the input explicitly replaces them. HA placement fields stay on the outer reference card. Details: Button Card templates.

7. Usage

Using a template creates a library reference. Local entities, variables, design fields, CSS and card-mod can then be adjusted. The interface generates insertion YAML and buttons for the selected template.

The converter workflow is:

  1. Add a new card to the HA dashboard and choose Vorlagenkarte.
  2. Select the desired existing Button Card template.
  3. Open “Vorhandene Button Card übernehmen” and paste the old card call into “Bisherige Kartenkonfiguration (YAML)”.
  4. Press “Für diese Karte übernehmen” and check the values.
  5. Open Karte bearbeiten (Edit card). For a new card, Einsetzen (Insert) applies the values to the previous HA card editor. The wide window closes; review the card in the HA editor and commit it to the dashboard with that editor’s regular Speichern (Save). For an existing card, Save in the wide window still saves directly. Alternatively use “Neuen YAML-Code kopieren” and insert the complete configuration at the desired dashboard location.

The converter validates YAML through the existing parser and changes only the local configuration in the open card editor. It does not directly save the central library or dashboard; the normal HA save operation commits the dashboard change.

A navigation button targeting the saved hash is sufficient for a popup. No extra popup card or grid placeholder is required. Standalone Bubble popups with cards:, classic vertical stacks with a popup header and ordinary cards can provide content. Multiple hash variants can reference one template; all buttons with the same hash share that saved variant. Explicit fire-dom-event calls with card_library remain available.

Bubble child-card editing uses a separate native HA dialog with its own save callback. Changes return to the embedded original editor and are saved through the existing workflow. The manager card's dashboard position is therefore not a save destination for the popup child.

UI dashboards are changed through Lovelace interfaces with fingerprint and revision checks. YAML dashboard configurations are exported for manual application. Usage counts cover saved links and statically recognizable popup calls; they are not click statistics.

8. Updating and migration

Update through HACS or install the complete integration archive. Restart Home Assistant, set the existing resource to /card_library/card-library.js?v=2.0.0 and fully reload the browser. When upgrading from local editor-09, remove the previous local query parameter. Keep the card_library domain, integration entries and .storage.

Back up library JSON, used dashboards and integration files before updating. Existing v1.1.0 templates need no manual conversion; Vorlage automatisch vorbereiten explicitly creates their new inputs. Prepared editor-09 templates remain usable. Older versions cannot fully read the new preparation and input metadata; restore compatible library and dashboard data before downgrading. Replacing program files does not revert saved data changes.

Internal updates now use the dispatcher as recommended in the HACS review. WebSocket commands and payloads are preserved; the previous card_library_updated event-bus event is no longer emitted. No additional HA login or manual storage migration is required.

Developer workflow and resumable complete updater: Publication.

9. Limitations and troubleshooting

Not every custom card has a graphical editor. Preloading does not guarantee completed network requests and cannot force a child's visibility-dependent initialization. Dynamic JavaScript/Jinja calls cannot be fully recognized statically. Automatic preparation converts only unambiguous supported occurrences; inspect notices, generated inputs and hiding in both preview and actual use. Bubble compatibility adapters check existing capabilities; incompatible versions produce a message and preloading falls back to loading on open. Child-card editors that cannot be isolated safely are blocked.

The converter rejects multiple or dynamic template references and conflicts with central bindings, including bound placement fields. Locally customized lists and extra_styles are stored as local snapshots; subsequent central changes to those specific fields do not propagate there. Central and local extra_styles contributions involving JavaScript are rejected because separate evaluations cannot be combined without loss. Remaining nested template references still need their definitions in the dashboard. Messages in the interface explain these limits.

For stale views, check resource version and browser cache. For missing cards, check third-party resources and entities first. Some tests use simulated HA interfaces; a complete live HA test with all themes and mobile devices has not been performed.

10. Development and tests

Use Python 3.12+, Node.js 22+ and requirements-dev.txt. Run npm test, python3 -B -m unittest discover -s tests, python3 tests/check_websocket_schemas.py, python3 scripts/check_release.py --configured and python3 scripts/build_release.py to check functions, WebSocket schemas, metadata and the installation archive. The public build contains all 21 frontend modules without a local identifier.

Passed: 1079 JavaScript and 239 Python checks, plus 69 distinct browser scenarios. Check scope, browser commands and actual limitations are documented in DEVELOPMENT.md. HACS, Hassfest and Tests must succeed for the exact release commit before publishing its tag and release. The user tested the local editor build in their HA installation; automated browser checks partly simulate HA interfaces and do not establish comprehensive live compatibility with all custom cards, themes and devices.

11. Version history

See CHANGELOG.md and GitHub releases. Entries describe published versions; local verification rounds receive no separate version.

12. Support, contributions, acknowledgements and license

Report issues with versions and a reproducible sequence through GitHub issues. Pull requests are welcome; see CONTRIBUTING.md. Thanks to Home Assistant, HACS and the developers of the supported original cards, particularly Bubble Card. Support via PayPal. License: MIT.

About

Reusable Home Assistant dashboard templates, shared settings and hash-based Bubble popups.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages