The community

The community is where Tiledash users share widgets, themes, partials and 3D models for floor plans. You can look around, try anything on your own devices, and install what you like. The widget picker and your floor plans’ furniture list the community’s widgets and models too, and adding one installs it; a theme or a partial is yours once you install it here.

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 Community in the sidebar. Along the top are its sections: Overview, a page each for Widgets, Themes, Partials and Models, then Installed and, once you publish something, Published.

Without an account

You don’t need an account to look around: anyone can open the community at community.tiledash.app, search it, open an item’s page and try it on the demo home. An item’s link there works for anyone you share it with. Install then says Log in to install: it takes you to the same item in Tiledash, where you log in with your Homey account (a new account is made on the way, and Free is enough) and come back to the item to finish installing it. Log in with Homey at the top does the same for the page you’re on.

Find something

Overview shows the three most installed of each kind, with See all for its page. Its search looks through every kind at once, by name, words in the description or the publisher’s name, and shows what it finds kind by kind.

Each kind’s page has the rest, searched the same way, by tag, and sorted by most installed, recently updated or newest, with filters of its own:

Widgets by what they Fit: one kind of device on your Homey, or Not about a device.
Themes: Light or dark.
Models by Type (what they are: sofas and armchairs, audio and video, vehicles…), the Room they’re meant for, their Brand, and where they Sit: floor, wall or ceiling. Show by lists them in sections by type or by room. Pick a brand, or open All brands, to see its models product by product.
Widgets and themes can leave out what loads from outside your Homey.

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

A model of a real product says which, by brand and product (Sonos Arc Ultra), and its page shows The real product: its type and room, what it is and how it looks. When one of your devices is that product, the page says so under Install: Fits your Living room Arc. For my devices lists only the models of your devices’ products and brands.

An item marked No longer maintained belongs to someone who left Tiledash. It keeps working and installing as it is, but nobody updates it any more. Their items that nobody used left the community when they did.

Items marked Official come from Tiledash itself, @tiledash. They are kept with Tiledash’s own code and checked like it, and each version says which change it came from. Search for @tiledash to see them all. Tiledash’s own widgets are in everyone’s widget picker with nothing to install, and your tiles of them update by themselves. Install one only if you want to keep it at the version you have: uninstalling it lets it update again, and your tiles stay.

Some of them used to be built into Tiledash: the car and charger widgets, the home battery, the appliance widget and the energy and price widgets. If you had one on a dashboard, your tiles moved to it with their settings and look, and they update by themselves. If you drew a widget of your own instead of one of them, your tiles show that widget, as before.

You don’t have to come here to find widgets: the widget picker’s Community tab has every widget in the community, those that fit your Homey first, and adding one installs 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 sample dashboard, with its background, its sidebar and tiles on and off. A theme that comes in light and dark has Light and Dark above it, and its card shows both halves.
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 community 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 community 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 gets a check mark on the widget picker’s Community tab, and appears among the widgets for the devices it fits.
A theme appears in the theme list of each dashboard and of This device…. One in light and dark offers Light, Dark and Auto, as your own pairs do.
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 community.
A model appears under From the Community in the floor plan editor’s furniture. Its page shows it in 3D to turn around first.

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, Community 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. Floor plans with a model on them show a plain piece in its place.

When the community can’t be reached

What you installed is kept in your Tiledash, so your dashboards, wall panels and share links keep working when the community is down for a while. Searching, installing and updating wait until it’s back; the community’s pages say so in the meantime.

Make it yours

Copy to my widgets on an item’s page, or Copy to my themes on Pro, 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 community has an open licence that allows copying. A theme in light and dark is copied as two themes of yours, paired.

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 community 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 community: 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 is free on every plan. You can publish up to 30 versions in any hour and 90 in any day, across all your Community items. Each publish counts for an hour (and a day) after you make it, so room comes back one publish at a time rather than all at once. Publish on its card in the Workshop does it for anything you made, and Publish to the community… in the editor of a widget, theme or partial (a theme in light and dark is published with both halves, its other half as it is saved now); the tutorial Publish your widget to the community goes through a first publish step by step.

Publishing goes in steps along the top: for a model first Product (the brand and product it stands for, kept on your model too; they fill in the title, address, summary and tags you haven’t changed yet), then About (title, address, summary), Description (with its tags), Pictures, Sharing (licence, links, who finds it), Version for a new version (which one, and what’s in it), What’s new and Check, a summary with Edit beside each line and Publish. Next checks the step you’re on; any step can be opened from the top. A new version starts on Version, with the listing as it was. What the steps don’t show:

Your community name (handle) can’t be changed once chosen.
Up to six tags, each up to 24 lower-case letters, digits and dashes; a space you type becomes a dash.
Tiledash suggests a patch, minor or major version from what changed. A version that breaks settings (a widget’s) or parameters (a partial’s) has to be a major.
A widget that loads outside addresses has to say why.
Translations go with the version: a new language is a new version, and a patch is enough. The community shows the languages an item has.
You pick which save to publish. Each version is fixed once published, but the listing (title, description, pictures and so on) can be changed at any time without a new version.

A model is published as you fitted it, with a copy of its file: changing or deleting your model later doesn’t change what you published. A connected AI assistant can also check and publish it, or a new version, after you approve the publishing details in chat. It can’t be downloaded as a package or published from the command line.

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 community, as its style joins the style of every widget that renders it. When a widget you publish renders a community partial, a copy of the version you have goes into the widget, and its page credits the partial.

Published in the community 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 community’s rules, and you get an email saying what and why:

Hidden: it leaves the community’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.

Models with appearance groups keep those groups when shared, including groups assigned to materials in imported files. Imported groups can retain their original texture, tint it, or replace it with another finish. After installing one, you can choose colours and finishes for each copy on your floor plan or in a Model widget. These choices leave the publisher’s defaults unchanged; pinned versions keep the defaults of that version.