Tiles in your Homey flows

The Tiledash app for Homey connects your Homey Pro to your dashboards both ways:

A tile tells Homey. Tap a Button and a flow starts with When … is pressed, knowing whether it was a tap, a hold or a double tap, and on which dashboard and screen.
Flows change the tile. A flow turns it on or off, gives it a text or a number, a colour or an icon, or hides it. Every screen showing the dashboard follows at once.

No virtual devices, Logic variables or webhooks in between. It comes with Pro, and needs a Homey Pro.

Connect the app

Connect each Homey once:

Install Tiledash from the Homey App Store on your Homey Pro.
In the Homey app, open the app’s settings and tap Get a code.
Tap Open Tiledash there, or in Tiledash go to Settings › Home › Homey app, choose Enter the code and type it.
Tiledash says what the app may do. Choose Allow.

Only someone who uses that Homey in Tiledash can allow it, and the app only ever works for that one Homey. The app reconnects by itself after a restart or an update.

Tell Homey from a tile

Edit the dashboard and open a Button’s settings.
On the Tap tab, pick Tell Homey for a tap, a hold or a double tap.
Under Homey tile, pick one, or choose New Homey tile… and give it a name as you’d say it in a flow: Movie night.

That name is a Homey tile: what your flows pick from a list. Several tiles can tell the same Homey tile, such as the phone and tablet layouts of one dashboard. The first time you open a tile’s Tap tab after connecting the app, a Did you know? points at it.

Tapping the Button now says Told Homey. When the app isn’t in touch, it says so, and the press doesn’t wait to be sent later.

The flow cards

In a flow, find the cards under Tiledash:

When [tile] is pressed. Its tags say how (Gesture: tap, hold or double), on which Dashboard, and on which Screen (a wall panel’s name; empty in the app).
And [tile] is on (or off).
Then:
- Turn [tile] on, off or the other way.
- Set [tile]’s text to … and Set [tile]’s number to ….
- Make [tile] …: its own colour, the accent, warm, cool, green, amber or red, as your dashboard’s theme draws them.
- Give [tile] the icon ….
- Make [tile] visible or hidden.

Each Homey tile’s on/off and text are tags too, for any flow.

What the tile shows

A Button that tells a Homey tile follows it:

On fills it; off leaves it plain.
A text or number shows on its second line.
A colour and an icon replace its own.
Hidden takes it off the dashboard. While you edit, it stays, marked Hidden now · A Homey flow hid it.

A dashboard opened later shows the Homey tile as it is now, even when no screen was open while the flow ran. When the app isn’t in touch, the Button keeps the last state and shows a plug.

Wall panels paired to your account follow the Homey tiles and can press them, as in the app. The flow’s Screen tag says which one.

A share link shows what your flows set, but can’t press: a press can start any flow, so on a link it stays with you, as starting a flow does.

Rename, remove or disconnect

Settings › Home › Homey app shows whether the app is in touch, its version, and who connected it. Under it are your Homey tiles:

Rename changes the name in Homey too. Flows keep working.
Remove takes it out of Homey’s list. Tiles that told it do nothing until you pick another.
Disconnect ends the app’s access. Tiles stop telling Homey until you connect again.

Only the Homey’s owner names, presses and removes Homey tiles for now. Everyone using the Homey sees what flows set.

On Free, presses and changes from flows stop. Your Homey tiles and how they look are kept for when you’re on Pro again.

What the app sends

The app and Tiledash exchange only what this needs: the names of your Homey tiles, what your flows set on them, and each press with its dashboard and screen name. The app reads nothing else on your Homey.