Drive card colours, titles and notifications from a Homey flow.
On this page
The HDashboards companion app is a Homey app. Installing it lets your Homey flows reach into your dashboards — and lets your dashboards hand control back to your flows.
Get it from the Homey App Store.
It is entirely optional. HDashboards works without it; the companion app adds the things a flow can drive.
What it adds
| Capability | What it means |
|---|---|
| Card colours | A flow can change a card's background colour while the app is running |
| Card titles | A flow can change the text on a card |
| Notifications | A flow can push a notification to the app |
| On-tap webhooks | A card tap can trigger a flow, so the flow decides what happens |
Card identifiers
Everything here works by identifier. Each card has a Companion app identifier in its Advanced tab — a generated number you can replace with something meaningful.
Rename them. front-door, washing-machine, kitchen-light make your Homey flows readable; 94224 does not. The identifier is how a flow says which card it means.
Several cards can share an identifier if you want them to change together.
Live card colours
The most popular use. A flow sets a card's colour based on something happening in the house:
- A door card turns red while the door is open, green when closed.
- A washing machine card turns amber when the cycle finishes, and back when unloaded.
- An energy card turns red during expensive tariff hours.
The colour set in the Style tab is the starting point; the flow overrides it while the app is running.
This gets you conditional formatting that no per-card setting could express, because the condition lives in Homey where all the information already is.
Live card titles
The same idea for text. A card's title can be set from a flow, so it can show a status, a count, or a next-event time computed in Homey.
On-tap webhooks
Set a card's on-tap behaviour to Companion and a tap no longer acts directly — it tells Homey the card was pressed, along with its identifier and which user pressed it.
A flow then decides what to do. This is how you build:
- One button that runs a different scene depending on the time of day.
- A tap that runs a sequence rather than a single action.
- A card whose meaning changes with who is home.
Because the flow receives the user, you can also make a button behave differently for different household members.
Setting it up
- Install the companion app on your Homey.
- Follow Companion app in the HDashboards side menu to link it to your account.
- Give the cards you want to control a meaningful Companion app identifier.
- Build flows in Homey using the HDashboards cards that appear.
Tips
- Name identifiers before building flows. Renaming one later means editing every flow that refers to it.
- Start with one card. Get a single colour change working end to end before building anything elaborate.
- Colour changes are live, not saved. They apply while the app is running; the card's configured style is what it returns to.