06 · Live signals

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.

1 · Conversation row: the six states

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.

#
#platform
9:45 AM
Tomasz: @you can you check the canary?
@3
1 Mention · unmuted channel, mentions > 0. Title 600 text, preview text, time accent, pill @3 on accent. Notifies.
IV
Ines Varga
9:39 AM
Are we still on for Thursday?
2
2 Direct · unmuted DM or group DM, unread > 0. Same strength as a mention: both are a person waiting. No @. Notifies.
#
Driftwood / #random
9:31 AM
Kwame: @you look at this
@1
3 Muted mention · muted, mentions > 0. Everything text_faint, weight 400, pill on quiet_fill with text_soft. Counts upward. Never notifies.
#
Driftwood / #gpui
9:15 AM
Odile: uniform_list only lays out what is on screen
4 Unread · unmuted channel, unread, no mention. Title 600, preview and time text_soft, 8 px accent dot. Never a count. Never notifies.
#
#announcements
8:13 AM
Office closed Friday for the move.
5 Muted · muted, unread or not. All text_faint, bell-off 12 px. No dot, sorts as read. An @everyone the network suppresses lands here or in 4, never in 1.
KA
Kwame Adeyo
7:44 AM
On it.
6 Read · title 400 text, preview text_soft, time text_faint, empty slot.
#
Driftwood / #random
9:31 AM
Kwame: @you look at this
@1
State 3 on a selected row: quiet_fill (white 12%) stays visible on selected (white 9%).
IV
Ines Varga
9:39 AM
typing…
2
Typing in a 1:1 · preview replaced by typing… in accent. Static, no dots. State and position unchanged.
LT
Lisbon trip
Yesterday
Ines is typing…
Typing in a group DM · the name is included. Channel rows never show typing.

1b · The same signals one level up: Group headers and Space rows

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.

Engineering4
Collapsed Group, number · 28 px header, pill h 16, 10.5 px bold. Label text_faint → text. No @ above row level.
Text channels
Collapsed Group, dot · 6 px dot.
Off topic1
Collapsed Group, quiet number · every number inside is a muted mention.
Archive
Collapsed Group, read or all muted · nothing.
Direct messages
Expanded Group · never carries a signal, whatever is inside.
NW
Northwind
Workspace · 42 channels
5
Space row, number · sum of DMs and mentions inside. Title 600.
DW
Driftwood
Server · 18 channels
Space row, dot · unread in a channel I follow, nothing addressed to me.
PK
Pixel Kitchen
Server · 96 channels
Muted Space · contributes nothing upward unless I am mentioned inside; then a quiet pill.

2 · Rail button: every badge and every connection state

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.

7

Inbox, numberequals the Dock badge

Inbox, dota starred channel is unread

3

NumberDMs + mentions

99+

99+cap

Dotunread, nothing for me

1

Quiet numberonly muted mentions

Connected, readnothing at all

NW
5

Pinned Spaceits own number

Connectingicon at 0.55, first 5 s

Reconnectinghollow, at once

3

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

3 · Typing row

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.

IV
Ines Varga9:39 AM
Are we still on for Thursday?
Ines is typing…
Message Ines Varga

One person. Live: stepped dots.

Ines and Tomasz are typing…
Message #platform

Two people.

Several people are typing…
Message #platform

Three or more. No names, no count.

Ines is typing…
Message Ines Varga

Still. Window not key, or 30 s of continuous typing: all three dots at 0.6, no timer.

Message Ines Varga

Nobody. The slot is empty but keeps its 20 px.

4 · Connection states: sidebar strip and composer line

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…

Reconnecting, after 5 s. warning on warning_soft. No action.

Can't reach DiscordRetry now

Offline, after 60 s with the Mac online.

Slack signed you outSign in again

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.

No internet connection

Mac offline. One neutral strip in every mode including Inbox; it replaces all per-network lines.

Message #gpui
Discord is reconnecting…

Reconnecting. Return still works: the message waits up to 60 s.

Message #gpui
Can't reach Discord. Messages won't send.Retry now

Offline.

Message #gpui
Discord is slowing things down. Sending in a moment.

Rate-limited, only when a send has waited over 2 s. text_soft: it is not an error yet.

Slack signed you out. Your messages are still here.
Sign in again

Session expired. The composer is replaced by a bar of the same 46 px height.

5 · Delivery and read marks

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.

Y
You9:46 AM
Thursday works. 10?
Y
You9:46 AM
Thursday works. 10?
Y
You9:46 AM
Thursday works. 10?
Y
You9:46 AM
Thursday works. 10?
Waiting for Slack…
Y
You9:46 AM
Thursday works. 10?
Not sent · Retry · Delete · You can't post here

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.

6 · macOS notifications

System notifications; drawn here only to fix the content. One per conversation, replaced in place. No avatar image in v1.

Ines Varga now

Are we still on for Thursday?
I can do 10 or 2.

Reply to InesSend

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.

Tomasz Brandt 2m ago#platform · Northwind

@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.

Ines Varga 5m ago

Missed voice call

Missed call.

Slack now

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.

Slack signed you out now

Open tinyclient to sign in again.

Session expired, posted once, only when the window is closed.

7 · Toasts

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.

#
#platform
Copied
Saved to DownloadsShow
Marked 14 conversations readUndo
Not sent to Ines VargaOpen
Slack signed you outSign in again
Couldn't open Teams

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.

8 · Dock badge and menu bar

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.

7

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.

Tue 9:46 AM