Polish 01 · The system, consistency and app chrome

The frames the other six designers draw against. Sizes are points at 1×. Every name is invented. Spec: docs/design/polish/01-system.md. No blur, no filters, no blend modes: only fills, borders, radii and drop shadows.

1 · Before and after: one cluttered list

Left: the Inbox as pre-polish draws it (from the inbox shot): colored network logos on every row, Space cut to one or two letters ("H… ›", "Fe… ›"), a pin glyph, "@n" pills, the same filled pill for plain counts, previews starting with my own name, accent counts on three rail buttons (32 = 22 + 10), 60-pt rows. Right: the same data under the calm rules: monochrome glyphs, the context after the title (dropped before it is cut short), Pinned and day headers instead of pins, one accent meaning, unfilled counts, my mention stripped from the preview, one number on the rail.

Before · pre-polish
32
22
10
Inbox
AllUnread 11Mentions 9
Jump to…⌘K
ML
Moss…›#showcase10:37 PM
I do have the keys. I checked twice.@1
ML
Moss & Lichen›#general10:30 PM
@Robin Vale need a yes or no on t…@2
IM
Ines Marchetti10:27 PM
And tell Tomasz, he never reads the…3
FC
Foray carpool10:19 PM
And the thermos.12
MO
Harbor La…›Mara Okafor10:15 PM
Also: the pager test at 4 is real this ti…2
TB
Tomasz Brandt9:24 PM
Ines says 7:30 at the usual corner. Bring…
MD
H…›Mara Okafor, Dev…9:14 PM
Democracy.3
MD
Mirela Dragan8:59 PM
@Robin Vale you left your gloves i…@1
IC
Fe…›Imogen Castellanos8:54 PM
Perfect. Can I collect them Thursday?1
After · calm rules C1–C14
14
RV
Inbox
AllUnread 11Mentions 4
Jump to…⌘K
Pinned
ML
#showcase · Moss & Lichen10:37 PM
Tomasz: I do have the keys. I checked twice.1
Today
ML
#general · Moss & Lichen10:30 PM
Ines: need a yes or no on the Saturday route2
IM
Ines Marchetti10:27 PM
And tell Tomasz, he never reads the channel3
FC
Foray carpool10:19 PM
Wren: And the thermos.12
MO
Mara Okafor · Harbor Labs10:15 PM
Also: the pager test at 4 is real this time2
TB
Tomasz Brandt9:24 PM
Ines says 7:30 at the usual corner. Bring…
MD
Mara, Dev, Imogen · Harbor Labs9:14 PM
Dev: Democracy.3
MD
Mirela Dragan8:59 PM
you left your gloves in the van1
IC
Imogen Castellanos · Fernhill8:54 PM
Perfect. Can I collect them Thursday?1

2 · The row family

Three heights, one anatomy: 28 places, 36 people in panes, 48 conversations. Inset 8, padding 8, radius 6, so every text column starts 16 (or 24 after an avatar) from the pane edge. States left to right in each column: rest, unread, mention, muted, hover (actions replace the right-hand marks in place), selected, keyboard focus (2-pt inset ring, separate from selection).

Conversation · 48 · avatar 32 · title 13 / preview 12 / time 11
TB
Tomasz Brandt9:24 PM
Ines says 7:30 at the usual corner.
IM
Ines Marchetti10:27 PM
And tell Tomasz, he never reads the channel3
ML
#general · Moss & Lichen10:30 PM
Ines: need a yes or no on Saturday2
MD
Mirela DraganYesterday
you left your gloves in the van1
YD
Yusuf Demirci · Fernhill
Daylight saving.
CW
Calla WinterbourneMon
You: sounds good, Friday then
HS
Haruto SendaOct 2
Place · 28 · glyph 16 or avatar 20 · name 13
trail-cams
gear-swap
map-layers1
off-topic
field-notes
showcase
photos
Servers
MLMoss & Lichen
SDSynth DIY
TTTiny Tools
Person · 36 · avatar 24 · name 13 + context 12 on one line
Online
AAnneke Visser · Harbor Labs
DDita Novak · Moderator
JJonas Feldt · in Campfire
EEmeka Nwosu · Fernhill
Offline
OOdalys Ferreira · last seen recently

3 · Badges, section headers, banner, buttons

One look per meaning. Mention of me: filled accent pill, numeral only. Messages to me: unfilled count. Ambient unread: dot (accent when a mention is inside). Muted: nothing, unless a mention. The rail carries one number, on Inbox. Section headers are 28 tall, 11/500 faint, sentence case, no rule and no count; the gap is the header.

Badges
3Mention of me · accent fill 12Messages to me · unfilled, text_soft 600 Unread somewhere · 8 dot A mention inside · accent dot 99+Past 99 14Rail Inbox: the one number = Dock badge Network and pinned buttons: dot only
Section headers · day groups · collapsed with unread inside
Pinned
ML
#showcase · Moss & Lichen10:37 PM
Tomasz: I do have the keys.1
Today
IM
Ines Marchetti10:27 PM
And tell Tomasz3
Yesterday
WH
Wren HalloranYesterday
You: see you there
Meetings
Archive
Banner · 32 · raised + hairline · color only in the glyph · buttons
PrimarySecondaryGhostDelete
AcceptDeclinerequests: no green, no bare ×

4 · Overlays stay inside the window

Fit order: preferred side, flip, shift along the edge, then shrink in height and scroll. 8 from every window edge. The modal scrim covers the whole window, rail and strips included; the traffic lights stay live above it. Stacking, bottom to top: panes · in-pane floats · floating sidebar · toasts · switcher · popovers and pickers · menus · modal · tooltips.

Context menu at the right edge
14
RV
showcaseMoss & Lichen › Trail
IM
Ines Marchetti10:29 PM
can you check #trail-cams before Saturday?
TB
Tomasz Brandt10:37 PM
I do have the keys. I checked twice.
clicked at x = W − 40: flipped left and up, 8 from the edge; the message keeps selected, its hover toolbar is hidden
Picker at the minimum window 540 × 440: the 352 × 400 picker opens above, shrinks to the room left minus 8, scrolls
14
RV
#showcase
IM
Ines Marchetti10:29 PM
can you check #trail-cams before Saturday?
TB
Tomasz Brandt10:37 PM
I do have the keys. I checked twice.
Search emoji
Recent
Message #showcase
Quick switcher
14
RV
Inbox
mar
Needs you
MMara Okafor · Harbor Labs2
MMarit Aasen · Moss & Lichen1
Recent
MMarigold Lane · Fernhill
Search messages for “mar”⇧⌘F
switcher: min(560, W − 48) wide, centered on the window, top 72, no scrim
Modal: scrim over the whole window
14
RV
Discord
MLMoss & Lichen
SDSynth DIY
#showcase
IM
Ines Marchetti10:29 PM
can you check #trail-cams before Saturday?
TB
Tomasz Brandt10:37 PM
I do have the keys. I checked twice.
Delete this message?
It is deleted for everyone in #showcase.
CancelDelete

5 · Window-level states

The window is never a blank canvas and never a developer instruction. The service is never named: people see "tinyclient". The last snapshot stays on screen whenever there is one; a banner says what is wrong; a sentence says what to do.

Starting · first 3 s · Skeleton rows after 150 ms; no words yet. Rail and strips are drawn from the first frame.
RV
Inbox
Jump to…
Pick a conversation
⌘K jumps anywhere.
Starting · after 3 s · Still no answer and the service process is alive: one banner, nothing else.
RV
Inbox
Jump to…
Waiting on the keychain · Status says waiting, or no answer at 3 s. Say so and say what to do; nothing to press.
RV
Inbox
Jump to…
Waiting for keychain access
macOS is asking to let tinyclient use its saved sign-ins. Choose Always Allow. The prompt may be behind this window.
Keychain denied or locked · Never read as signed out; nothing is deleted.
RV
Inbox
Jump to…
tinyclient can’t read its sign-ins
Your accounts are still signed in. Allow access to continue.
Try again
Reconnecting · The service went away mid-session. The last snapshot stays; the shell restarts it; Send waits.
14
RV
Inbox
Jump to…
ML
#general10:30 PM
Ines: need a yes or no2
IM
Ines Marchetti10:27 PM
And tell Tomasz3
FC
Foray carpool10:19 PM
Wren: And the thermos.
TB
Tomasz Brandt9:24 PM
Ines says 7:30
#general
IM
Ines Marchetti10:29 PM
can you check #trail-cams before Saturday?
TB
Tomasz Brandt10:37 PM
I do have the keys. I checked twice.
Couldn’t restart · Three restarts in 30 s failed, or a version mismatch.
14
RV
Inbox
Jump to…
ML
#general10:30 PM
Ines: need a yes or no2
IM
Ines Marchetti10:27 PM
And tell Tomasz3
FC
Foray carpool10:19 PM
Wren: And the thermos.
TB
Tomasz Brandt9:24 PM
Ines says 7:30
#general
IM
Ines Marchetti10:29 PM
can you check #trail-cams before Saturday?
TB
Tomasz Brandt10:37 PM
I do have the keys. I checked twice.
After a crash · Relaunched by the panic hook. Error toast; stays until dismissed.
14
RV
Inbox
Jump to…
ML
#general10:30 PM
Ines: need a yes or no2
IM
Ines Marchetti10:27 PM
And tell Tomasz3
FC
Foray carpool10:19 PM
Wren: And the thermos.
TB
Tomasz Brandt9:24 PM
Ines says 7:30
#general
IM
Ines Marchetti10:29 PM
can you check #trail-cams before Saturday?
TB
Tomasz Brandt10:37 PM
I do have the keys. I checked twice.
tinyclient quit unexpectedly and reopened.Copy report
An account needs you · One line in that network’s home and in the Inbox.
14
RV
Inbox
Jump to…
ML
#general10:30 PM
Ines: need a yes or no2
IM
Ines Marchetti10:27 PM
And tell Tomasz3
FC
Foray carpool10:19 PM
Wren: And the thermos.
TB
Tomasz Brandt9:24 PM
Ines says 7:30
#general
IM
Ines Marchetti10:29 PM
can you check #trail-cams before Saturday?
TB
Tomasz Brandt10:37 PM
I do have the keys. I checked twice.
All signed out · The window offers the way in, not a blank list.
RV
Inbox
No conversations yet
Sign in to a network to see your chats.
Sign in to start
Discord, Slack, Telegram and Teams in one small window.
DiscordSlackTelegramTeams
Never again · today’s screen when the service is absent
chatd isn't running
Start it with `cargo run -p chatd`. This window reconnects on its own.

6 · The menu bar, every menu open

Native NSMenus (drawn here in the system style, not ours). Keys agree with the navigation spec and the panes spec. Items that do not apply are disabled, never hidden; names follow the open place ("Mark Workspace as Read", "Open in Slack"). macOS adds Dictation, AutoFill and the tiling items itself.

tinyclientFileEditViewConversationWindowHelp
tinyclient
About tinyclient
Check for Updates…
Settings…⌘,
Services▸
Hide tinyclient⌘H
Hide Others⌥⌘H
Show All
Quit tinyclient⌘Q
File
New Message⌘N
Add Account…
Attach File…⌘U
Close Window⌘W
Edit
Undo⌘Z
Redo⇧⌘Z
Cut⌘X
Copy⌘C
Paste⌘V
Paste and Match Style⌥⇧⌘V
Select All⌘A
Find▸
Search in Conversation⌘F
Search Everywhere⇧⌘F
Emoji & Symbols⌃⌘Space
View
Inbox⌘1
People⌘2
Discord⌘3
Slack⌘4
Moss & Lichen⌘5
Quick Switcher⌘K
Hide Sidebar⌘\
Close Right Pane⌘.
Bigger Text⌘+
Smaller Text⌘−
Actual Size⌘0
Enter Full Screen⌃⌘F
Conversation
Back⌘[
Forward⌘]
Up a Level⌘↑
Next⌥↓
Previous⌥↑
Next Unread⌥⇧↓
Previous Unread⌥⇧↑
Mark as Read
Mark as Unread⌥⌘U
Mark Server as Read⇧⎋
Show Details⌥⌘I
Star
Mute…
Start Call⇧⌘C
Open in Discord⌥⌘O
Copy Link
Window
Minimize⌘M
Zoom
Fill · Center · Move & Resize▸
tinyclient
Bring All to Front
Help
Search
Keyboard Shortcuts⌘/
Release Notes
Copy Diagnostics
Report a Problem…

7 · Dates and times, one formatter

12/24-hour follows macOS. No relative times. Labels roll over once at midnight.

AgeRow (11)Message timeDay dividerTooltip on any time
Today10:37 PM10:37 PMTodayTuesday, October 13, 2026 at 10:37 PM
YesterdayYesterday10:37 PMYesterday
2–6 daysMon10:37 PMMonday
This yearOct 210:37 PMFriday, October 2
Older10/2/2510:37 PMOctober 2, 2025

8 · Feedback

Rows open on mouse-down: the selected fill and the new title strip land in one frame. Buttons act on mouse-up and show pressed while held. Focus rings are for the keyboard only. Tooltips appear whole after 500 ms.

Focus, press, tooltip
Focused primary Pressed secondary Focused field Members ⌥⌘I