Releases: raetha/ha-dockhand-cards
Releases · raetha/ha-dockhand-cards
Release list
Dockhand Cards v1.1.0
Added
- Overview card editor gained two new layers of customization, both reached via icons next to
each row in the editor: a global default per card type (display mode, which per-row details
show, and link visibility, applied to every environment unless overridden) and a
per-environment override of any of those same settings for one specific environment. Also new:
show/hide icons for individual environments and for each card-type section. - Stacks and Containers list cards can now show or hide individual per-row details (update
badges, container count, CPU/memory, etc.) instead of always showing everything, and gained the
same "Show link to open in Dockhand" toggle every other card already had. - Container card now shows the image/tag and an "Update available" badge when one's pending.
Stack card's member container list now links each container through to its own status, and
(with ha-dockhand 1.8.0+) shows container names. - Every card's "open in Dockhand" link now shows a clear, explained icon if Home Assistant can't
resolve a working link for it, instead of silently failing or looking identical to the link
being turned off.
Changed
- Editor controls across every card are more consistent with Home Assistant's own forms: dropdowns
render compactly instead of sometimes expanding into a list, "pick several" fields use checkboxes
instead of switches, hint text now scales with your HA accessibility text-size setting, and a
missing-entity warning appears as a native alert next to the relevant field. Overview card's
editor also reorganized its section/environment toggles to use the same show/hide and edit icons
throughout. - More editor text is translated, including per-mode help text (also shortened to focus on
genuinely useful information, like a feature needing a specific sensor enabled) and each card's
link tooltip. - Two Overview card config keys were renamed for consistency (
environment_overrides/
environment_order→environments_overrides/environments_order). Existing configs keep
working automatically — nothing to change. - Environment card label pills now use Dockhand's own per-label colors instead of a plain
neutral pill.
Fixed
- "Hide when no updates" (Updates card and Overview's own equivalent) could hide a card that
genuinely had a pending update, if that update was on a system container or one only found by
the optional precise-update-check feature. Requires ha-dockhand 1.8.2 or later to fully
fix; see that repo's own changelog. On an older ha-dockhand, behavior is unchanged from before. - All six cards' "open in Dockhand" links now validate consistently — three previously showed
a link that silently did nothing if Home Assistant's configured Dockhand URL had a subtle
formatting problem (also fixed in ha-dockhand 1.8.2); the other three already handled this
correctly. - Fixed several small icon-alignment issues where an icon sat slightly off-center next to its text,
across the Container, Stack, Overview, and Updates cards. - The Container and Stack card editors' dropdowns now sort alphabetically, matching every other
dropdown in these editors.
Dockhand Cards v1.0.0
Initial release.
Added
Eight cards, all built on the same principles: zero manual entity configuration (pick a device
from a dropdown, the card resolves what it needs itself), no credentials of their own (read-only
against hass.states/hass.entities/hass.devices, same trust boundary as any Lovelace card),
graceful degradation (a disabled or missing entity means that value or section is simply left
out, never a broken layout), click-through to more-info on every entity-backed value — including
each individual stat where a card shows several (a container's health icon, CPU, and memory each
open their own entity, not just the container's overall state) — and icons via <ha-state-icon>
so a user's own icon customization is reflected automatically.
- Dockhand Environment Card — modeled directly on Dockhand's own dashboard tile, in five
modes: Compact (name/online/counts), Standard (+ CPU/memory, health, resource counts, events),
Detailed (+ top containers by CPU and recent events), Full (+ a disk usage breakdown and a
15-minute CPU/memory history chart with a hover tooltip — matching Dockhand's own window and
layout, verified directly against its source rather than assumed), and Custom (pick exactly
which sections to show, independent of the four fixed combinations above). - Dockhand Vulnerability Card — an environment's vulnerability scan summary (total findings,
critical/high/medium/low breakdown, scan coverage), matching Dockhand's own severity colors. - Dockhand Stack Card — a Compose stack's status, container count, pending updates, and (for
git-tracked stacks) sync status, last sync time, and sync errors. - Dockhand Container Card — a container's state, health, CPU/memory usage, and network/block
I/O. - Dockhand Stacks Card and Dockhand Containers Card — every stack/container in one
environment, one compact row each. Auto-detected; nothing to configure beyond the environment. - Dockhand Updates Card — every pending container update, scoped to one environment or all of
them, with "Check for updates" and bulk "Update all" actions, and per-container more-info
click-through for a targeted install. Optionally hides itself entirely when there's nothing
pending (hide_when_no_updates) using Home Assistant's own native card visibility feature —
genuinely gone, not just empty — while still showing normally while editing the dashboard, so
there's always something to click on to configure it. - Dockhand Overview Card — one card intended to fill an entire dashboard: every environment as
its own column (sorted by name, manually reorderable in the editor), each stacking whichever of
Environment/Vulnerability/Updates/Stacks/Containers you enable, in a drag-to-reorder sequence —
so everything about one environment stays together. Defaults to environments only. Side-by-side
columns collapse to one at a time, in order, on narrow screens. Its own per-environment Updates
section can hide the same way (updates_hide_when_no_updates) — genuinely taking up no space
when hidden, since it's a plain part of this card's own layout. - Supports Home Assistant's resizable "sections" dashboard view (
getGridOptions) as well as the
classic masonry view (getCardSize). - Every card supports Home Assistant 2026.6's entity-first card picker (
getEntitySuggestion) —
picking a relevant ha-dockhand entity offers the matching card as a suggestion. - Editor labels are translated into the same 10 languages as ha-dockhand (German, Spanish, French,
Italian, Norwegian Bokmål, Dutch, Polish, Portuguese, Swedish, Simplified Chinese), looked up
fromhass.language. Custom mode's section-checkbox labels specifically are English-only for
now — seedocs/BACKLOG.md.