Skip to content

Installation

Before a card can be used in a Home Assistant dashboard, the Flexible Horseshoe Card JavaScript resource must be installed and available to the dashboard. HACS is the recommended installation method, while manual installation is available when you prefer to manage the file yourself.

This page walks through both methods and shows how to verify that Home Assistant recognizes the card.

Home Assistant version

Flexible Horseshoe Card requires Home Assistant 2026.4 or newer so names, states, attributes, units, and translations follow Home Assistant consistently.

Install with HACS

hacs_badge

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Use the button above to open the repository directly in HACS.

HACS can install both stable and latest available releases. The latest release may be a pre-release or development version, so use the stable release when reliability is more important than early access to new features.



stable stable-date
latest latest-date
downloads

After installation, restart or reload Home Assistant if required, then refresh the dashboard before adding the card to a view.

Manual installation

Use manual installation when you want to manage the JavaScript file yourself.

  1. Download dist/flex-horseshoe-card.js from the GitHub releases page.
  2. Copy the file to the config/www directory in Home Assistant.
  3. Add the file as a Lovelace resource.

The file becomes available in Home Assistant at:

/local/flex-horseshoe-card.js

Add the following resource definition:

1
2
3
resources:
  - url: /local/flex-horseshoe-card.js  # URL loaded or opened here
    type: module

Dashboard editor

When using the dashboard editor, add the resource through the dashboard resource settings or the raw configuration editor.

YAML mode

When using YAML mode, add the resource to the resources.yaml file included by your ui-lovelace.yaml configuration.

After adding or replacing the file, refresh the browser cache so Home Assistant loads the latest version.

Verify the installation

After installing the resource, add a card with:

1
type: custom:flex-horseshoe-card  # Home Assistant must recognize this custom card type

If Home Assistant recognizes the custom card, the installation is complete.

If the card is not found, check that:

  • the file exists in config/www
  • the resource URL is /local/flex-horseshoe-card.js
  • the resource type is set to module
  • the browser is not using an older cached file