Every part of the screen you can style has a name tag. This page lists them all (about 150 in
the first version). You do not have to learn them: Design mode shows
the tag of whatever you point at, and the editors autocomplete them.
the checkbox fill reads checkbox.checkedFill, which falls back to color.accent
More dots = more specific.dialog matches every dialog. dialog.confirm matches every
confirm dialog. dialog.confirm.replaceRun matches one. The more specific tag wins.
A part carries its general and its specific tag. Styling card changes every card; styling
feed.card changes only feed cards.
Label tags show a name or a short text: a tab, a sidebar row, a chip, a button, a table
cell, a menu item, a breadcrumb item, a card title, and the label tag itself. Every label tag
has the truncate setting for long text. See
When text is too long.
Every dialog purpose and every toast kind has its own tag. The build makes it, so a new dialog
cannot ship without one.
Tags grow on demand. Want to style something with no tag? We add one. A tag is never removed
without the update steps.
The list comes from the app’s own parts, so it always matches the real app.
The sidebar has five sections: Views, Hubs, Chats, Favorites and Collections. A collection
row is one button: it opens the collection page and never lists its entries. An entry row (in
Favorites, a hub or a view’s pinned page) can open into a tree of its sub-entries.
Tag
Pieces
States
sidebar
—
collapsed
sidebar.header
logo, collapseButton
—
sidebar.search
—
focus
sidebar.section, with sidebar.section.views, .hubs, .chats, .favorites, .collections (and .globalCollections, kept for older designs)
title, addButton, empty
open
sidebar.row
icon, label, count, toggle, menu, children (the tree under an open entry row), rest
hover, current, dragging, dropTarget, open
sidebar.footer
avatar, name, plan
—
There is no section for the tree. The tree opens under an entry’s own row: that row is open,
and its sub-entries sit in its children piece.
Top of the page and the phone tab bar
Tag
Pieces
States
topbar
back, status (saving and sync), menu, favorite
—
breadcrumb
item, separator
current
collectionChip
icon, label
—
tabbar (phone)
item, icon, label
current, pressed
moreMenu (phone)
row
—
The phone tab bar is drawn by the phone itself, so it takes theme colours and fonts only.
Screens
A page is a screen. Each screen has a page tag.
Tag
Pieces
page (any screen), with page.form, .reading, .page, .board, .canvas, .content, .full (the widths)
settingsPage (settings pages that are not protected)
section, row
libraryPage
listing, listingCover, filters
On all three pages, the viewTabs piece holds the one tab bar, tabs.bar. The tab bar looks
and works the same on all three.
A dashboard has no tag of its own. It is an entry in the Dashboards collection, so it is an
entryPage with a grid. To style all your dashboards, style them with the place This
collection on the Dashboards collection.
Block pages, dashboards and blocks
A Block page or a Dashboard property holds blocks. Each block type has its own tag. The block types are
on Blocks and charts.
Tag
Pieces
document (a Block page property)
blockHandle
grid (a Dashboard property; its settings include the gap between tiles)
block.chart, with one tag per chart kind (the 22 kinds); block.view; block.entry; block.columns (Block page only); block.html (your own HTML, CSS and JavaScript in a sealed frame)
Views and their items
Tag
Pieces
States
view
toolbar, queryBar, groupHeader, empty, addRow
—
table
header, headerCell, gridLine
—
table.row (also row)
cell, gutter, handle
hover, selected, dragging
list.row (also row)
handle, rest
hover, selected, dragging
board.column
header, count, addButton
dropTarget
board.card (also card)
—
hover, dragging
gallery.card (also card)
cover
hover
mosaic.tile (also card)
—
hover
feed.card (also card)
—
hover
feed.dateSeparator
—
today
books.shelf
—
—
books.cover (also card)
—
hover
calendar.grid
day, timeRuler, nowLine, weekStrip, miniCalendar
day has today, weekend
calendar.event, with calendar.event.block, .pill, .dot
title, time, resize
hover, dragging, past
subEntries.row
handle
—
Controls
Tag
Pieces
States
checkbox
box, mark
checked, mixed, disabled, hover, pressed, focus
button, with button.primary, .secondary, .ghost, .danger, .iconOnly
badge, with badge.neutral, .success, .warning, .danger, .plan
—
—
chip (entry chips, reference pills, the active timer and run pills)
icon, label
—
tabs, with tabs.section, .pill (other tab looks)
item
current, hover
tabs.bar (the one tab bar of collection, global collection and hub pages; also has overflow)
item, linkMark (the ↗ on a tab from another place), more (the More ▾ menu), add (the + button)
current, hover
label (the one icon-and-name control, inside tabs, sidebar rows and titles; setting show: both · icon · name)
icon, name
—
segmented
item
current
tooltip, infoHint
—
—
scrollbar
thumb, track
hover
dragHandle, resizeHandle
—
hover, dragging
focusRing, selection, searchHighlight
—
—
emptyState, progressRing, workingDots
—
—
The tab bar and the label
One tab bar.tabs.bar is the tab bar of every collection, global collection and hub.
Its tabs show views or entries. tabs.section and tabs.pill are other tab looks.
The link mark. In a collection’s tab bar, a tab that shows something from another place
(a dashboard, another collection’s view, a global view) has a linkMark piece: the ↗.
Hubs show no link marks.
The label. Each tab item, each sidebar row and each title holds one label. Style label
to change all of them at once. In a sidebar row, the label fills the row’s icon and label
pieces.
fullscreen.stopwatch, fullscreen.entry (an entry that fills the screen, such as a run while it records)
Most removals are instant with an Undo toast, so few confirm dialogs are left.
Toasts and status
Tag
Pieces
Notes
toast, with toast.success, .error, .info, .undo (also “Moved to Trash”), .celebrate, .notification, .custom (a toast your design shows)
icon, message, action, close
never hidden; error and Undo toasts stay at least 6 seconds
syncStatus
—
the saving and sync dot
inlineError
—
for example the chat error line
Chat
Tag
Pieces
chat
switcher, divider
chat.message, with chat.message.user, .assistant
bubble, markdown, attachments, sources, menu
chat.composer
field, attach, voice, send, contextPill
chat.toolCard, with chat.toolCard.choices, .job, .actions
header, body
chat.working
—
Protected screens (not styleable)
These names exist so documents and tests can refer to them. No design can style them, not even
Free CSS. They carry no general tag, so a rule for dialog or button never reaches them.