Skip to content

Repository files navigation

Orbit Cards

Downloads hacs_badge GitHub Release License Home Assistant Maintenance GitHub Stars GitHub Issues

Orbit Cards is a collection of modern Home Assistant dashboard cards and badges. Every component shares the same visual language and editor experience, with flexible layouts, dynamic colours, custom icons, templates, and configurable interactions.

Install Orbit Cards directly from the default HACS repository, then configure its cards and badges from Home Assistant's dashboard editor.

Documentation · Installation guide · Examples · Screenshots


Cards and badges

Area Card

custom:orbit-area-card

Orbit Area Card

An area overview with status text, a main entity, side buttons, curved quick actions, and navigation.

Area Card guide

Status Card

custom:orbit-status-card

Orbit Status Card modes

Visual entity summaries in Standard, Person, Icon only, and compact grouped Icon only modes.

Status Card guide

Action Card

custom:orbit-action-card

Orbit Action Card group

Compact controls for scenes, scripts, automations, buttons, cameras, and grouped shortcuts.

Action Card guide

Deck Card

custom:orbit-deck-card

Wrap

Orbit Deck Card wrap layout

Tabs

Orbit Deck Card tabs layout

A generic container that wraps Lovelace cards into rows, switches between them with tabs, or places compact cards over a main card.

Deck Card guide

Status Badge

custom:orbit-status-badge

Badge

Orbit Status Badge using the Home Assistant Badge type

Heading badge

Orbit Status Badge using the Home Assistant Heading badge type

Active entities

Orbit Status Badge active entities dialog

Flexible entity, area-count, and template-driven status indicators for Home Assistant badge rows and card layouts.

Status Badge guide

Features

  • Built-in visual editors with grouped, Home Assistant-style controls.
  • Shared colour handling with theme colours, named colours, CSS colour values, preview swatches, and light-derived colours where supported.
  • Material Design Icons, bundled orbit: icons, local SVG/image icons, and configurable active and inactive icon states.
  • Tap, hold, and double-tap interactions with more-info, navigation, service calls, popups, and optional Browser Mod and Bubble Card integrations.
  • Native Home Assistant Jinja rendering and live entity updates for components that support templates.
  • Compact grouped layouts for Status and Action cards, plus Deck Card Wrap, Tabs, and Overlay layouts for any Lovelace card.
  • Deck Card child visibility, automatic layout reflow, transparent backgrounds, and per-item padding controls.
  • Unavailable-entity indicators across Area, Status, and Action cards.
  • Translations for English, British English, German, Spanish, French, Italian, Dutch, and Brazilian Portuguese.

Full configuration references and YAML examples are available in the Wiki.

Installation

HACS

  1. Open HACS in Home Assistant.
  2. Search for Orbit Cards.
  3. Select Orbit Cards, then choose Download.
  4. Refresh Home Assistant when the download is complete.
  5. Add an Orbit card or badge from the appropriate dashboard picker.

Manual

  1. Download orbit-cards.js from the latest release.

  2. Copy it to:

    /config/www/orbit-cards.js
    
  3. Optional: to use bundled orbit: icons, copy manifest.json and the bundled .svg files beside orbit-cards.js in:

    /config/www
    
  4. In Home Assistant, go to SettingsDashboardsResources.

  5. Add this resource:

    /local/orbit-cards.js
    
  6. Set the resource type to JavaScript module.

  7. Refresh Home Assistant.

See the installation guide for more information.

Updating

After updating, refresh the browser or reload Home Assistant frontend resources. Some browsers and Home Assistant apps cache frontend modules aggressively, so a hard refresh may be needed before changes appear.

Compatibility

  • Home Assistant Lovelace dashboards running Home Assistant 2025.6.0 or newer.
  • Available from the default HACS repository, with manual resource installation as a fallback.
  • Browser Mod is required only for Browser Mod popup actions.
  • Bubble Card is required only for Bubble Card hash popups.
  • custom:orbit-room-card remains registered as a legacy alias for custom:orbit-area-card.
  • room_name remains supported as a legacy alias for area_name.
  • Legacy Area Card configs are migrated when the editor opens: custom:orbit-room-card is rewritten to custom:orbit-area-card, and room_name is rewritten to area_name.

See the migration guide for legacy configuration details.

Support

Credits

Created by AndyBlac and released under the MIT License.

Releases

Packages

Used by

Contributors

Languages