Publishing something
Share any of the ten kinds — and what the sheet checks before it goes out.
Anything you have built can go in the Library. Publishing shares how it is put together — never anything you have logged.
Where to publish from
From the thing itself, wherever it lives:
| To publish | Open |
|---|---|
| A Collection | its ⋯ menu → Publish to the Library… |
| A board | the dashboard tab's ⋯ menu |
| One widget | the widget's settings dialog → Publish… |
| A view | view settings |
| A preset | the preset row's ⋯ menu |
| An automation | the rule's ⋯ menu |
| An agent | the agent card |
| A skill | from Publish your own in the Library |
| A theme | your theme list |
Or, from the Library itself, Publish your own — one button, for when you have just seen someone else's and thought "I have one of those".
All of them open the same sheet. There is no shorter version on a smaller screen, and the phone has it too.
Starting from the Library
Publish your own opens a full page and asks one question first: what kind of thing is this? Pick Collection, Dashboard, Agent, System, Widget, View, Preset, Automation, Skill or Theme, and everything after that follows from your answer — including a System, which you build there rather than pick.
Then: which one of yours, its own settings, what goes out with it, the details, examples where they help, and the review.
Setting the thing up before you share it
Right after you pick one of yours, you get its real editor — the same one you use in the app, right there in the flow. Not a short version of it.
| You picked | You get |
|---|---|
| A Collection | its whole page: the name and icon, the description, the properties, views, presets and the card layout (JSON drawer and all) |
| A view | its filters, sorts, grouping and style |
| A preset | its starting values, its icon and its card |
| A board | the real board, with its widgets, skin, theme and styles |
| A widget | its full settings — data, style and layout |
| An automation | the rule, its switch and its editor |
| An agent | its picture, name, chat background and personality |
| A skill | its name, its one-line description and the whole instruction |
| A theme | every colour, font, icon and control shape |
Three things to know:
- You are editing the real one. Changes save to your account as you make them, exactly as they would anywhere else in the app. That is on purpose — what you share should be what you kept.
- The name here becomes the listing's name. Rename the Collection on this step and the listing follows it.
- Only the thing you picked is on screen. A board you are publishing is pinned here on its own — no strip of your other boards to click through, and nothing you do in the flow changes which board you are working on back in the app. You can still edit it; you just cannot wander off it.
Building a System skips this step — the assembler is its editor.
On the phone this step gives you a button that opens the thing's own screen. Change what you like, come back, and the flow is exactly where you left it.
Everything that goes out with it
Most things are not one thing. A board is the collections its widgets read, the widgets themselves, and often a look you built for it. A view is the view plus the Collection it reads. An agent is the agent plus its skills. So the step after the settings — Parts — lists everything that is about to go out, one row each, whatever you are publishing.
Each part becomes a page of its own that people can copy on its own, and every one of those pages says what it belongs to. Someone who wants just your Habits Collection can take just that; someone who wants the whole board gets everything in one go.
On the Parts step:
- One row per piece, saying what it is and what will happen to it: a new listing, an update to one you already shared (will become V2), or will be referenced as it is when nothing about it changed.
- Required rows are locked, and say why — "required — the widget charts it", "required — it runs the automation". These are the things without which what you are sharing does not work.
- Everything else is a tick box — "included — untick to leave it out".
- Edit opens that piece in its own real editor, the same way the step before does for the main thing.
- Every Collection needs its own three examples. The row tells you which one is short, and you can write them or generate them right there.
- The look is optional. If it wears a theme you made, the theme goes out as its own listing with a tick beside it — untick it and everything still works, it just arrives in whatever theme the copier already uses.
- A Collection's views, presets and automations can get their own pages. They travel inside the Collection either way; ticking one adds a separately copyable page for it. Off by default.
- Anything that cannot travel is listed. A tile pinned to one of your own entries points at a row nobody else has, so it is left out — and the step says so rather than letting the board arrive with a hole in it.
Nothing is ever shared behind your back. Every piece is one you walked past on this step and read on the Review step.
If you share the same Collection twice — once on its own, once inside a board — it stays one listing with two homes, not two copies that drift apart.
When publishing refuses
Anything that reads a Collection has to bring that Collection. If it cannot — you unticked it, or it has nowhere to come from — the step says so in plain words, on the button, before anything is published:
This view needs its collection published with it.
That is not fussiness. Without it, the page strangers land on would preview an empty frame, and copying it would give them a view over nothing.
The same applies to a preset, a widget, and an automation and the agent it runs as.
Before your first one
One thing you do once:
- The Publishing Rules. Read and accept them once. If they change materially, you will be asked again.
Every listing shows your username, so there is no anonymous publishing. You already have one — it is the name in your sidebar, and you got it when you signed up. Change it in Settings → Profile if you want a different one before you publish.
The steps
Details — three tabs: About, Description and Banner. (Updating something you have already shared adds a fourth, What changed.)
About is the name, the one line under it, and the tags.
Tags are how people find you when they browse. Start typing and you get the
tags the Library already uses, most-used first, with how many listings carry
each. Pick one, or type something new and choose Create. Every tag you pick
sits underneath as a chip — tap the × to drop it. Reusing an existing tag is
worth doing: a listing tagged workout shows up beside every other one, while a
listing tagged workouts sits on its own.
Description gets a tab to itself, because it is the page strangers read. It is a proper editor with the whole page to work in: headings, lists, quotes, links, bold and italic. Two things it deliberately cannot do — mention one of your own entries or pages, and hold an image. Nobody reading your listing has your entries, so a mention would be a dead link for them; the banner is the one picture a listing gets.
If you paste a link that points back into your own app, the sheet says so and offers to remove it. Your words stay; only the link goes.
Examples — only when there is something to show filled in; a theme, an agent or a skill skips this step. A template is hard to judge empty, so a listing carries three example rows, and you edit them the same way you edit real entries:
- Table — a column for every property, so you can fill in what a row actually looks like, not just its name. Add more rows if three is not enough; three is the minimum a listing needs.
- Feed — the same rows drawn as the real cards. This is what a stranger sees, so it is worth a look before you publish.
Or hit Generate examples and they are made up from the shape of your Collection: its property types, your tag names. They are never rows you logged.
Review — two halves, and both are worth the minute.
It opens with your page, as strangers see it: the real listing page, drawn from what you have typed and ticked so far — the banner, the tags, the hero, the tabs. Not a mock-up of it, the page itself. If the preview looks empty or the summary reads oddly, that is what people will land on.
Underneath is every string that will become public, listed and editable in place. Publishing several pieces groups them by piece, so you can see which listing each line belongs to; you edit a piece's own words in that piece's editor, on the Parts step. This is the half worth slowing down for. Most of these words you wrote months ago inside the structure — a Collection description, a tag label, a property name — and nobody re-reads those before sharing them.
If something looks off, the sheet says so:
- Some things stop the publish and quote the rule they break.
- Some are advisory — an email address in your description might be deliberate. It tells you and lets you decide.
The button is never greyed out without a reason next to it.
Three ways to change something you shared
Fixing the words — a typo, a clearer summary, a better banner. Open the listing and hit Edit listing (it only shows on your own), or go through your Published page (from the Library, or search "Published") and hit Edit. Either way it opens the same full-screen editor you published in — the name, summary and tags on one tab, the description on a tab of its own with room to write, the banner on a third — and Save takes you straight back with the change already showing. This does not make a new version and does not touch the template itself, so it still works even if you have since renamed or deleted the Collection it came from. You can edit an archived listing too, which is usually what you want: fix it first, then re-list it.
Changing what it points at — the same editor has a Links section: every listing this one points at, what each is to it ("part of this", "its look", "needed by this"), and an Add link row for pointing it at something else you have published. Changing a link changes what a copy brings along, and it does not mint a new version.
Two links cannot be removed, and each says why on its own row rather than just refusing: the Collection something reads (without it the listing would preview empty and copy broken), and a piece that was published as part of this listing.
Changing the template — you added a property, a view, a preset. Publish the same thing again and it updates rather than duplicating: the button says Update listing (V2), and you can write a short note saying what changed. Every version is kept, so what someone copied last month stays exactly as it was.
Unpublishing, and bringing it back
Your Published page lists everything you have shared, with how many times it has been copied and starred. Search it, or filter to just the archived ones. It is on the phone too, from the Published button in the Library.
Unpublish any of it: the page stops working, it leaves search, and copies people already made are theirs and stay working. Changed your mind? Re-list puts it back.
One thing you cannot change is the address. People have shared that link and search engines have indexed it, so it stays as it was.