The store

The store holds widgets, themes and partials that other Tiledash users made and published. You can look around, try anything on your own devices, and install what you like. Nothing from the store shows up in your widget picker, your theme list or your widgets until you install it.

A partial is a piece of a widget, like a sprinkler that turns while it waters, that your own widgets render. Partials explains them.

Open Store in the sidebar. It has three tabs: Browse, Installed and, once you publish something, Published.

Find something

Browse shows everything in the store. Search by name, words in the description or the publisher’s name, narrow it to widgets, themes or partials or to a tag, and sort it by most installed, recently updated or newest.

Each card shows the widget drawing with demo data, the theme on a few tiles, or the partial in a plain tile, with its publisher and how many people installed it.

Try it first

Open an item to see its page: what it does, screenshots, its licence and where its source lives, its versions with what changed in each, and what it was copied from.

A widget draws in the preview with the demo home, or with Your devices: pick one of yours that it fits, and see it at three sizes.
A theme shows on a few tiles.
A partial draws in a plain tile, with a control for each of its parameters (a switch for a yes/no, its choices, a colour…), so you can see every state it has. Under it is the line a widget renders it with, and Render it beside it has that line to copy.
A widget that brings a store partial with it lists it under Uses; you don’t need to install that partial.
Compare shows what changed between any two versions, file by file.

Outside addresses

Some widgets load pictures from another website, a weather camera for example. That site can then see when your dashboard is open and from where. Tiledash finds these on its own, and the publisher has to say why the widget needs them.

You see a warning with the addresses and the publisher’s reason on the store card, on the item page, in the install dialog (which asks you to confirm), when an update adds a new address, and in the widget picker. No outside addresses in the filters hides them.

Install it

Install on an item’s page adds it to your account:

A widget appears under Installed in the widget picker, and among the widgets for the devices it fits.
A theme appears in the theme list of each dashboard and of This device….
A partial can be rendered by your own widgets, by its id: {% render '@ann/sprinkler', on: cap.onoff.value %}. The widget editor’s autocomplete lists it, and Your widgets lists it under From the store. Your own widgets need Pro.

Installing is free on every plan. Only you see what you installed; your share links and wall panels draw it too.

Updates

When a publisher puts out a new version, Store in the sidebar shows a count, and Installed lists the update with what changed. For each one you can:

Update: move to the new version. If its settings changed in a way that some of your tiles need to be set again, the dialog lists those tiles first. For a partial, it lists the widgets of yours that won’t fit the new version, with what goes wrong in each.
Show changes: see the difference before you decide.
Not now: hide this version’s notice. The next version brings it back.

Update by itself updates an item as soon as a new version comes out, within the same major version (1.2 to 1.3, but not to 2.0). It asks you instead when a new version loads from an outside address it didn’t before. A version within the same major never breaks your tiles’ settings, or the renders your widgets write for a partial.

Going back

Earlier versions… in an item’s menu lists every version. Use this version goes back to one. A version its publisher withdrew can’t be installed again, but if you have it, it keeps working.

Uninstalling

Uninstall… says what changes first. Tiles that used a widget go back to the built-in widget it was based on. A widget that wasn’t based on one can only be uninstalled together with its tiles. Dashboards that used a theme go back to your screen’s theme. A partial can’t be uninstalled while a widget of yours renders it: the dialog names those widgets, so you can take it out of them first.

Make it yours

On Pro, Copy to my widgets or Copy to my themes on an item’s page makes a copy you can change in the editor. Before it does, it says what the difference is: a copy is yours to change and stays as you leave it, while installing uses the item as it is, with its updates, so you can choose Install instead. Every item in the store has an open licence that allows copying.

The copy keeps where it came from: the editor says “Copied from” with the item and its version, and what that one was copied from in turn.
Partials the widget uses come along as your own. One is renamed when you already have a partial with that name, and so is a copy of a store partial it brings: @ann/sprinkler in a widget called Garden becomes your garden-sprinkler.
A partial has no Copy to my partials: install it and render it, or read its code on its page and the command line’s tiledash pull.
When the item gets a newer version, the editor offers to bring the changes into your copy, as it does for copies of built-in widgets. Its renders use the names your copy gave the partials, and partials the new version adds come along as your own.

Report a problem

Report this widget (or theme) at the bottom of an item’s page tells Tiledash something is wrong: it does something harmful, doesn’t work, copies someone’s work, is offensive, or something else. Say which version, and what you saw.

Tiledash looks at every report. The publisher is never told who sent it. You can have one open report per item.

When Tiledash takes an item down, what you installed tells you under Installed:

Removed from the store: nobody can find or install it any more, but your copy keeps working.
Taken down: it was blocked for safety and draws nowhere. Go back to a version that isn’t blocked, or uninstall it.

Publish your own

Publishing needs Pro. The first time, you choose a store name (your handle, like @sam) and a display name. Your Homey account’s name and email stay private.

From the editor of one of your widgets, themes or partials, Publish to store… asks for:

a title, a summary, a description, tags, an icon and screenshots. Up to six tags, each up to 24 lower-case letters, digits and dashes; a space you type becomes a dash;
a licence, from a list of open licences;
the version: Tiledash suggests a patch, minor or major from what changed, and a version that breaks settings (a widget’s) or parameters (a partial’s) has to be a major;
why it loads outside addresses, when it does;
which save to publish, and what’s new in it.

Each version is fixed once published. Your listing (title, description, pictures and so on) can be changed at any time without a new version.

A partial is published with its parameters. It may render only Tiledash’s partials, and its class and animation names should start with its name in the store, as its style joins the style of every widget that renders it. When a widget you publish renders a store partial, a copy of the version you have goes into the widget, and its page credits the partial.

Published in the store lists your items with their installs and any open reports. For each item you can:

edit the listing;
Withdraw… a version: nobody can install it any more, but those who have it keep it;
unlist an item: it leaves search and browsing, but its link works and those who have it keep it;
Delete… an item nobody has installed.

You can also publish a zip, or use the command line from your terminal or GitHub Actions with a publish token made under Published.

When Tiledash steps in

Tiledash can hide, remove or block what goes against the store’s rules, and you get an email saying what and why:

Hidden: it leaves the store’s lists and search; its link still works.
Removed: nobody can find or install it.
Blocked: for something harmful; that version, or every version, stops drawing for everyone.