Card and row designs
A card design decides what a card or row shows, where each thing sits, how it looks and what a click does. The view sets a few fixed rules; inside them, the card is yours.
Where a card design lives
- The collection has one card design per view kind: feed card, board card, gallery card, list row, table row, calendar event, books cover and mosaic tile. New views use it.
- A view uses the collection’s design, or has its own.
- An entry can change its own card. Example: a gold border on one special diary entry.
What a card design holds
| Part | What it is | Example |
|---|---|---|
| Layout | which fields show and where; one of stack, inline, grid or overlay |
the checkbox over a picture |
| Items | a field, text, an image, an icon, a group, a button or a spacer | the Done field, “3 days left” |
| Looks | background, border, radius, padding, shadow, hover, and the look of every item | this card’s checkbox is a star |
| Size rules | changes for a screen size, or for the card’s own width | a narrow card shows only the checkbox |
| Value rules | changes when a value matches | when Done is ticked, fade the card; when overdue, a red border |
| Clicks | what a click does | open the entry, play an animation, show a toast |
Fields you do not place do not show on the card. They stay on the entry page.
A field always works as its standard editor. A checkbox on a card ticks the same way as on the entry page. You can change its look (a ring, a star) but not how it edits.
A long title wraps, then it is cut. A card title wraps up to the number of lines you set for the card, then it ends with “…”. See When text is too long.
Fields are stored by id, shown by name. You write “Done”; the app stores the property’s id. So renaming the property never breaks a design.
Example: a habit card
In the Habits feed, each card shows only the Done checkbox in the top-right corner, as a gold star that bursts with confetti when ticked. A smiling GIF plays in the middle.
On the Habits feed view:
{ "view": { "background": { "fill": "gradient", "from": "var(--color-surface)", "to": "var(--palette-peach)" } }, "card": { "layout": { "kind": "overlay", "height": 160 }, "items": [ { "image": "asset:smile", "align": "center", "size": 96, "play": "always" }, { "field": "Done", "align": "topRight", "parts": { "checkbox": { "mark": "star", "size": 28, "checkedFill": "var(--color-highlight)" } }, "moments": { "checkbox.tick": { "effect": "confetti" } } } ] }}The same card can be written in HTML and CSS instead. Both are one design; see the Card layout language.
What a click does
A design can open something, play an animation and show a toast. A button the design adds can make its one change: set the value it names, add the tag it names, start or stop its timer, or start recording on a JSON property that records. Example: the Start run button on a run’s card starts recording its Route. See Record a GPS run.
Anything more is an Automation. If ticking Done should also add the tag Finished and raise the Streak, the “What happens when ticked” panel creates an Automation on the Habits collection. It runs however the box gets ticked: on this card, in a table, on the entry page, by the AI or from your phone.
A design can never delete, move to the Trash, move to another collection, share, or change privacy, plans or settings.
Screen sizes
The defaults already work on phone, tablet and desktop. Add a rule only where you want something different.
| Rule | Looks at | Names |
|---|---|---|
| Screen | the window | phone (under 600 px), tablet (600–1023), desktop (1024 and up), wide (1440 and up), or your own numbers |
| Own size | the card’s own width | small (under 240 px), medium (240–479), large (480 and up), or your own numbers |
Own-size rules matter most for cards: the same card is narrow in a board column and wide in a feed. Table and list rows follow the view’s width.
Each view keeps a few fixed rules
| View | Fixed rule |
|---|---|
| table | a row stays one row; columns stay aligned |
| board | cards fit the column width; drag and drop works |
| gallery | cards share one size per view |
| mosaic | tiles pack the grid |
| feed | newest first unless you sort; an empty field is left out, except the boxes you fill on the card (numbers, checkboxes, ratings, stopwatches, sub-entries) |
| books | covers keep the book shape |
| calendar | an event stays inside its time and day; it opens on today’s week until you move it |
In every view, filtering, sorting and grouping stay fixed.