A number means someone needs me. A dot means there is something new. Healthy is silent. Every value swaps in one frame; the only motion in this file is the three typing dots in frame 3. Spec: docs/design/06-live-signals.md.
64 px row, first match wins. The badge slot is a fixed 18 px at the right end of line 2, so nothing re-wraps when a state changes.
text, preview text, time accent, pill @3 on accent. Notifies.@. Notifies.text_faint, weight 400, pill on quiet_fill with text_soft. Counts upward. Never notifies.text_soft, 8 px accent dot. Never a count. Never notifies.text_faint, bell-off 12 px. No dot, sorts as read. An @everyone the network suppresses lands here or in 4, never in 1.text, preview text_soft, time text_faint, empty slot.quiet_fill (white 12%) stays visible on selected (white 9%).typing… in accent. Static, no dots. State and position unchanged.A parent's number is the sum of the numbers inside. A parent's dot means "no number, but an unmuted channel inside is unread". Never both. Expanded headers show nothing: the rows speak.
text_faint → text. No @ above row level.Top right is "what is waiting" (pill 18 px or dot 8 px, each on a 2 px rail-colored ring). Bottom right is "what is wrong with the link" (7 px in an 11 px ring). A healthy, read network shows neither.
Inbox, numberequals the Dock badge
Inbox, dota starred channel is unread
NumberDMs + mentions
99+cap
Dotunread, nothing for me
Quiet numberonly muted mentions
Connected, readnothing at all
Pinned Spaceits own number
Connectingicon at 0.55, first 5 s
Reconnectinghollow, at once
Reconnecting + numberlast known count stays
Offlinesolid warning, after 60 s
Session expiredsolid danger, icon 0.55
Signed outicon 0.4, no dot
Mac offlinehollow, faint: not its fault
Notifications pausedbell button, warning
A fixed 20 px slot directly above the composer, always reserved, so messages never shift. Three 4 px dots in an 18 x 6 px box; the lit dot steps every 400 ms (2.5 changes a second, no easing). No avatars. This is the only motion in the product's live signals.
One person. Live: stepped dots.
Two people.
Three or more. No names, no count.
Still. Window not key, or 30 s of continuous typing: all three dots at 0.6, no timer.
Nobody. The slot is empty but keeps its 20 px.
Strip: 28 px under the search field, in Network and Space mode for that network. Composer line: the existing 12 px line under the field. Both appear only after 5 s of trouble; a blip changes nothing but the rail dot. No countdowns.
Reconnecting, after 5 s. warning on warning_soft. No action.
Offline, after 60 s with the Mac online.
Session expired. danger on danger_soft. The cached list stays below it. Not the same as never signed in, which shows the sign-in prompt instead of a list.
Mac offline. One neutral strip in every mode including Inbox; it replaces all per-network lines.
Reconnecting. Return still works: the message waits up to 60 s.
Offline.
Rate-limited, only when a send has waited over 2 s. text_soft: it is not an error yet.
Session expired. The composer is replaced by a bar of the same 46 px height.
One 12 px glyph after the timestamp of my newest message only. Telegram and Teams direct chats get sent and read; every network gets pending and failed.
In order: pending (row at 0.55, no glyph) · sent check · read check-check in accent · waiting for the link · failed circle-alert in danger with the reason in words.
System notifications; drawn here only to fix the content. One per conversation, replaced in place. No avatar image in v1.
Are we still on for Thursday?
I can do 10 or 2.
DM, two messages in a burst: one notification, newest lines in the body, the second made no sound. Reply expanded. Actions: Reply, Mark as Read.
@you can you check the canary before we roll to prod?
Mention. Subtitle is channel and Space. A thread reply reads Thread in #platform · Northwind.
New mention
Text hidden (our "Show message text" off, for screen sharing). On a locked Mac the system does the same with its own setting and shows only New message.
Open tinyclient to sign in again.
Session expired, posted once, only when the window is closed.
Only for the result of something I just did that is not visible where I am looking. Top center of the conversation pane, 12 px under the header. One at a time; a new one replaces the old. Opaque surface with a shadow, no blur, no slide, no fade.
2 s plain, 5 s with an action, 6 to 8 s for the two that need me. "Not sent" appears only when that conversation is not the open one; otherwise the message row already says it.
The Dock badge is the sum of every number (DMs + mentions) and nothing else; the system draws it. The menu-bar item is how I know tinyclient is still receiving with the window closed, and where I stop it.
Dock: 7. Cleared at zero. Never a dot.
Menu-bar glyph, static template image: all quiet · something is waiting · a network is offline or needs sign-in. No number.