Installation¶

The recommended way to install the Flexible Horseshoe Card is through HACS. This keeps the setup straightforward and makes future updates easier to manage.

Manual installation is also available when you prefer to manage the card files yourself.

Install with HACS¶

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.

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

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

Related links¶

• HACS
• Flexible Horseshoe Card releases
• Home Assistant