Skip to content

Releases: raetha/ha-dockhand-cards

Dockhand Cards v1.1.0

Choose a tag to compare

@raetha raetha released this 28 Jul 16:42

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_orderenvironments_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

Choose a tag to compare

@raetha raetha released this 22 Jul 04:37

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
    from hass.language. Custom mode's section-checkbox labels specifically are English-only for
    now — see docs/BACKLOG.md.