Skip to content

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

  1. 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.
  2. A view uses the collection’s design, or has its own.
  3. 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.

A habit card with an overlay layout: a smiling GIF in the centre and the Done checkbox as a star in the top-right corner. The entry page stays normal.Habits feed cardGIF★Done, top rightEntry page: unchangedDrink waterDone ☐Streak 12Tags Health
The design belongs to the Habits feed view. The entry page has its own design, which you did not change.

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.