A card your AI assistant designs for you.
On this page
A card your AI assistant designs for you. Describe what you want to see, such as "a big clock with today's date in Dutch" or "a countdown to our holiday", and the assistant builds the card's content and puts it on your dashboard.
This card is marked Experimental in the app.
How it works
The assistant writes the card as a small web page, which the app shows the way a Webview card shows HTML. You cannot edit that content in the app. To change it, ask the assistant: "make the text bigger", "use our brand colours", "show seconds as well".
In the app you can still move, resize, duplicate and remove the card, and on the Advanced tab set its colours and what a tap does.
The card's name
Every AI card has a name, such as "Living room panel". Use it to tell the assistant which card you mean: "on the living room panel, make the buttons bigger". An empty AI card shows its name, and you can change it under Name in the card's settings. It is the same as the companion app identifier on the Advanced tab.
Adding one
Ask your assistant for the card, for example "an AI card for the living room with the lights as big buttons and the temperature on top". You can also add an empty AI card from the card list in the app; it shows "Ask your AI assistant to build this card" until the assistant has filled it.
Your devices on an AI card
An AI card can show your Homey devices live and, if you ask for it, switch them: a room panel with all its lights, a scene board, a big energy display, a heating control in your own design.
The assistant lists exactly which devices and values the card may use, and which of them it may switch or set. The card sees nothing else in your Homey and can change nothing else. Ask the assistant which devices a card can control when you are not sure; it tells you before it adds the card.
A few things keep it safe:
- No internet. The card cannot load anything from the internet or send anything to it. It only talks to the HDashboards app on your screen.
- No tokens. The card never gets your Homey login; the app switches the devices for it.
- PIN codes hold. A card with a PIN code switches nothing until the code has been entered, and nothing is switched while you edit the dashboard.
For a single switch or value, a regular Device or Gauge card is faster and simpler.
Flows and variables
An AI card can also start your Homey flows and show your variables: a row of scene buttons such as "Movie mode" and "Goodnight", the value of a logic variable, or a switch for a yes/no variable such as "Guests staying".
- Flows. The assistant lists exactly which flows the card may start. It cannot start any other flow. Turn on Needs confirmation? on the Advanced tab and the app asks "are you sure?" before the card starts a flow.
- Variables. The card can read the flow tokens and logic variables the assistant lists, such as the weather temperature or a counter you keep in a flow. It can change only the logic variables listed as changeable (Homey's own variables, under Logic); values that an app or a device reports can only be read.
The assistant tells you which flows the card can start and which variables it can change before it adds the card. The assistant itself never starts a flow or changes a variable; only you do, by tapping the card. The same safety applies as for devices: no internet, no Homey login for the card, and nothing is started or changed while the card is locked with a PIN code or while you edit the dashboard.
For a single flow button or value, a regular Flow or Flow token card is simpler.
Sharing a card
You can share an AI card with everyone. Open the card's settings in the app, switch on sharing, and give it a public title (up to 60 characters) and a short description (up to 200). Only you can do this; your assistant never shares a card for you.
A shared card appears in the AI card gallery, where it runs on demo data, and other people can use it as a template for their own devices. What is shared:
- the title and description you gave it,
- the card's design, with your device ids, flows and variables replaced by stand-ins (device-1, flow-1, token-1, …),
- which kinds of devices and values it uses, such as "a dimmable light" or "a power meter", how many flows it starts and which kinds of variables it uses, such as "2 number variables, 1 of them changeable".
Your name, your Homey, your device, room, flow and variable names and your live values are not shared. The design is shared as your assistant wrote it, so if you asked for a device's name to be written into the card, that text is part of it; ask your assistant to take it out before you share.
Changes to the card show up in the gallery after you save it. Switch sharing off, remove the card or change it into another card type, and it leaves the gallery; a card back from the trash is shared again. HDashboards can hide a shared card from the gallery.
Demo values
In the gallery a card runs on made-up values that move a little, so it looks alive. Your assistant can give it better ones, such as "the power between 200 and 900 W" or "the heating set to 21 °C". Ask for it when you build a card you might share. Variables can have demo values too, and flows a sample name such as "Movie mode" instead of their real one. These values are only used in the gallery, where starting a flow does nothing.
A card that shows text, such as the next pickup date of each waste container, needs demo values: the gallery can make up numbers, but it cannot guess what a text means, so the card shows its "no data" state. Ask your assistant to "give this card demo values" before you share it. Dates can be relative to today, so they never go stale.
Templates
Every card in the gallery is also a template. Open it, copy the line under Ask your assistant, and paste it to your assistant, for example: "Build an AI card from the HDashboards template “Dining lights” for my devices". The assistant reads the template, finds the matching devices in your Homey, tells you which ones it picked and which the card can switch, and adds the card once you agree. When the template starts flows or shows variables, the assistant asks you which of your own flows and variables to use.
A whole screen: AI boards
An AI card sits on the grid with your other cards. For one design that fills the whole screen, such as a wall panel or a TV status screen, ask your assistant for an AI board instead: a dashboard that is one AI card. Its card may show up to 200 device values, 200 flows and 200 variables instead of 50 each.
Performance
Like a webview, an AI card is a small browser inside a card. One or two are fine; many on a wall panel will be felt.