TopLine · Human Interface Guidelines
The single law every TopLine surface obeys.
One ramp for type. One symbol family. Four semantic colors. A floating material for things that overlay. Empty states that are content, not absence. Voice that’s plain and direct. We grade every screen against one bar: would Jony Ive ship this on apple.com?
Principles
The five rules.
01
One mind
Every screen should feel like it came from one person. Consistency beats local cleverness.
02
Color is information, never decoration
A near-monochrome surface palette, one brand accent, four semantic tones. If you reach for color to make something "pop," stop.
03
The states no one demos are the product
Empty, loading, and error get the same care as the happy path. We grade ourselves on what most teams skip.
04
Direct, plain, human
No tool names, no jargon, no emoji as chrome. We say "Searching your knowledge base," never "mcp:rag_search."
05
Material follows function
Translucent where things overlay. Opaque where things are the page. Liquid Glass as restraint-reference, not as a thing to copy.
Type
One ramp.
Eight steps. Picked once, used everywhere. Weight is 400 body, 500 medium for labels, 600 for titles. Never 700 in-app.
text-micro11px
wm-text-caption12px
wm-text-small12px
wm-text-body13px
wm-text-body-lg15px
wm-text-title-s18px
wm-text-title22px
wm-text-display-s28px
wm-text-display32px
Symbols
One family.
One stroke weight (1.75 on a 24 grid). Round caps + joins. Our own — drawn at one weight so the whole product reads as one mind. Emoji are allowed only in user-authored content, never as chrome.
todaymeetingsaccountswatchlistcadencesdocumentspipelinemy-workassistantteamleadershipadminnumbergrowthpracticealertsnetworkvoice-notesaved-commandsbookingrocketdealengagementactivitysignalsecurityplugsparkleboltinboxcheckchartpeoplebuildingbookclockSpace & radius
Four-px base.
One spacing unit (4px). p-5 (20px) is the standard card padding; p-6 (24px) is airy/hero. One card radius — 16px — everywhere. Drop the drift.
wm-space-14pxwm-space-28pxwm-space-312pxwm-space-416pxwm-space-520pxwm-space-624pxwm-space-832pxwm-space-1040pxColor
Information, never decoration.
Near-monochrome surfaces. One brand accent for the one thing the eye should find. Four semantic tones for state. If you reach for color to make something pop, stop — hierarchy comes from type weight and spacing.
Brand
Success
Attention
Critical
Field labels
The label is what the eye scans for.
A label that names a value is bold and the same strength as the value under it. Muted 12px is for the line that comes after the value: a date, a count, a source.
Imputed defaults
Never make someone type what we already know.
A prepopulated field shows its value in amber italic until it’s reviewed — by editing it, or with the one “Accept N suggestions” button at the lower left of the form. Try it below: edit a field, or accept, and watch the amber clear.
Toggle pill
Say the state. Click to flip it.
When a record has two states and the flip is rare, a small pill names the current one and a click switches it. It asks first only when the flip is risky, shows the new word while it saves, and puts the old word back if the save fails. Three or more choices stay a segmented control.
Flips after a confirm and a short save. Switching back asks nothing.
This one always fails, so you can see the word roll back and the reason appear.
Menus
A glyph on every row.
A menu row is a small glyph and a few words, like a row in the sidebar. You never pick the glyph: it comes from the words, so “Edit” is a pencil and “Delete” is a bin. A screen can name one when its words are unusual. Glyphs stay one muted tone, and a destructive row turns red. A row whose words name no known action gets a quiet dot, never a blank. Open the three menus below.
You picked: Nothing yet
Working mark
The bars are doing the thinking.
One mark for work of unknown length: the assistant thinking, a button in flight, a page on its way. It is the three bars of the TopLine mark, breathing. The two large sizes add a slow swell and a soft band of light. Under reduced motion it holds still. A list or card whose shape is known keeps its skeleton rows instead.
sm · 16px
Inline: buttons, chips, one-line strips
md · 20px
A message or a small panel
lg · 48px
A whole page loading, with its name
hero · 128px
A full-screen cover
Crew faces
A small crew, each with a face.
The assistant and every Crew Member wear a drawn character: a head in the brand colour, features in its ink. Each state reads without colour. Idle blinks now and then, working scans, needs you lifts its brows, done winks and smiles, paused and stopped close their eyes. Under reduced motion each face holds a still frame of its state. There are two sets side by side: twenty-five hand-drawn characters, and sixteen built from a small grammar.
Drawn characters
99 characters in 4 families. Each has one picture per state. An idle character blinks and a working one scans, with the same motion as the faces below, and all of them hold still when you ask for reduced motion.
Signals
Orbit · Keeps the whole account in view
Radar · Finds the next opportunity
Comet · Moves fast on new leads
Beacon · Flags what needs attention
Prism · Turns complexity into clarity
Satellite · Listens across every channel
Ember · Quiet Account Finder
Echo · Lookalike Finder
Meridian · Market Keeper
Sieve · Signal Source Tuner
Lookout · Watchlist Keeper
Flint · Lead Finder
Herald · Account News Watcher
Lode · Market Opportunity Finder
Swivel · Champion Change Watcher
Spark · Idea Generator
Horizon · Strategic Brief
Barometer · Forecast Caller
Loupe · X-ray Watcher
Contour · Market Heat Map
Antenna · Audience and Ratings Data
Instinct
Owl · Researches before reaching out
Fox · Finds a clever way forward
Sprout · Nurtures growing relationships
Moth · Notices the faintest signal
Bear · Steady support when it matters
Whale · Handles the big accounts
Monkey · Curious, resourceful, and quick to connect
Dowser · Contact Finder
Facet · Personality Reader
Strata · Revenue Explorer
Whistle · Call Coach
Perch · Team Account View
Refrain · Buyer Asks
Canary · QA Keeper
Parley · Built in: Chat
Pigeon · Emailed Report Feeds
Momentum
Relay · Passes the right work along
Loop · Brings renewals full circle
Sail · Keeps an opportunity moving forward
Rocket · Gets new accounts off the ground
Stride · Makes consistent progress
Tide · Makes follow-through feel natural
Marquee · Finds prospects at local events
Culvert · Keeps the data feeds flowing
Tempo · Keeps every cadence on the beat
Sounding · Measures what the buyer needs
Turnstile · Lets bookings in one at a time
Pacer · Sets the pace to hit the goal
Trio · Recaps the top three of the day
Dusk · Wraps up the day for managers
Dawn · Starts each seller day with a brief
Summit · Gives managers the view from the top
Weir · Measures the flow of the pipeline
Sandglass · Watches reply times run
Mooring · Holds the CRM connection fast
Courier · Carries email to the right record
Tether · Keeps every connection attached
Baton · Watches each play pass step to step
Muster · Calls the roll for the whole crew
Craft
Folio · Arrives with the brief prepared
Quill · Finds the words that land
Keeper · Protects trust and commitments
Patch · Connects the missing pieces
Dial · Makes every conversation count
Loom · Weaves the details together
Hinge · Agency Link Keeper
Atlas · Territory Planner
Abacus · Lead Score Keeper
Coffer · Co-op Dollar Finder
Mortise · Record Matcher
Granary · Data Steward
Postmark · Deliverability Guard
Inkwell · Blog and Social Kit
Easel · Pitch Librarian
Docket · Research Desk
Lexicon · Knowledge Librarian
Lapel · Meeting Recorder Check
Storyboard · Campaign Desk
Slate · Report Runner
Tack · To-do Keeper
Bulletin · Digest Check
Bellhop · Support Ticket Watcher
Grout · Fills the gaps in every record
Lever · Pulls the action that moves an account
Manifest · Lists what came in on the load
Stamp · Gives the OK before work goes out
Keyring · Holds the key to every tool
Meter · Measures what the AI uses
Custodian · Looks after the workspace
Trellis · Frames the panels and alerts you build
Reel · Brings recordings in from other tools
Switchboard · Connects your texts and calls
Register · Keeps the book of records
Mailslot · Takes the email you drop in
Inset · Puts TopLine inside your CRM
Logbook · Records what ran and when
Bobbin · Pulls each web page in
Ballast · Keeps the hosting steady below
Business
68 characters in 10 families. Each has one picture per state. An idle character blinks and a working one scans, with the same motion as the faces below, and all of them hold still when you ask for reduced motion.
Finance
Ledger · An open ledger with a tracing entry.
Invoice · A crisp invoice and running payment marker.
Cashflow · Opposing transfers around a reserve.
Budget · An allocation gauge over calibrated bars.
Reconciliation · Two aligned records and a matching check.
Governance
Approvals · An executive approval stamp and signed page.
Compliance · A shield carrying an audit checklist.
Contracts · A folded contract with a fine drafting pen.
Risk · A calibrated risk dial within a shield.
Audit · A magnifier inspecting documented evidence.
Promise · Two cords tied in a square knot
Operations
Schedule · A bound calendar with an active date.
Workflow · Three sequenced work stages with routing.
Projects · A project board with staggered timelines.
Capacity · Three instrumented workload columns.
Quality · A precision caliper checking a component.
Stages · Steps with a check
Customer
Support · A professional headset and clear audio signal.
Inbox · A letter entering a structured mail tray.
Routing · A switchboard distributing incoming requests.
Crm · A contact register with connected records.
Feedback · A speech panel and measured response marks.
Profile · Record card with a plus
Missed · Calendar day with an empty chair
Reply · Reply arrow on an envelope
Cues · Teleprompter with cue lines
Strategy
Analytics · An analytical report with a rising trend.
Forecast · Observed performance leads to a projected path.
Research · A lens examines an open reference book.
Strategy · A compass focused on the next direction.
Goals · Concentric objectives and an on-target marker.
Quarterly · Calendar split into four quarters
People
Recruiting · A search lens over a candidate profile.
Onboarding · An access card beside a welcoming entry.
Learning · An open manual and focused knowledge ray.
Payroll · A pay statement with a currency seal.
Performance · A review card with measured achievement bars.
Captain · Star with rank bars
Technology
Security · A secure lock protected by a precise shield.
Access · An access key with an indexed credential.
Infrastructure · A stacked server rack with live indicators.
Automation · A controlled gear and connected process node.
Integrations · Two complementary connectors join systems.
Steward · Database protected by a shield
Tuner · Funnel and adjustment dial
Supply chain
Procurement · A requisition list and verified sourcing basket.
Inventory · A labeled stock carton on a measured shelf.
Logistics · A delivery vehicle and tracking route.
Fulfillment · A prepared parcel with a completion seal.
Facilities · A managed building with a service tool.
Package · Matched box with a check
Growth
Sales · A measured funnel with an advancing opportunity.
Marketing · A broadcast horn with measured outgoing signals.
Publishing · An editorial page with a publish arrow.
Campaigns · A campaign flag and scheduled milestones.
Partnerships · Two linked agreements form a shared connection.
Quote · Price tag on a page
Speed · Stopwatch
Calling · Phone beside a list
Proposal · Proposal with a progress bar
Discount · Percent tag with a stamp
Knowledge
Records · A structured archive with an indexed record.
Search · A lens over a concise index.
Translation · Two text panels connected by a translation bridge.
Documentation · A bound technical manual with active annotations.
Handoff · A work packet passes between two stations.
Notes · Notepad with a pen
Library · Shelf of books
Portraits
75 portraits, one picture each. An idle portrait blinks. A working one breathes and tilts, and all of them hold still when you ask for reduced motion.
Portrait 01 · Drawn in ink
Portrait 02 · Drawn in ink
Portrait 03 · Drawn in ink
Portrait 04 · Drawn in ink
Portrait 05 · Drawn in ink
Portrait 06 · Drawn in ink
Portrait 07 · Drawn in ink
Portrait 08 · Drawn in ink
Portrait 09 · Drawn in ink
Portrait 10 · Drawn in ink
Portrait 11 · Drawn in ink
Portrait 12 · Drawn in ink
Portrait 13 · Drawn in ink
Portrait 14 · Drawn in ink
Portrait 15 · Drawn in ink
Portrait 16 · Drawn in ink
Portrait 17 · Drawn in ink
Portrait 18 · Drawn in ink
Portrait 19 · Drawn in ink
Portrait 20 · Drawn in ink
Portrait 21 · Drawn in ink
Portrait 22 · Drawn in ink
Portrait 23 · Drawn in ink
Portrait 24 · Drawn in ink
Portrait 25 · Drawn in ink
Portrait 26 · Drawn in ink
Portrait 27 · Drawn in ink
Portrait 28 · Drawn in ink
Portrait 29 · Drawn in ink
Portrait 30 · Drawn in ink
Portrait 31 · Drawn in ink
Portrait 32 · Drawn in ink
Portrait 33 · Drawn in ink
Portrait 34 · Drawn in ink
Portrait 35 · Drawn in ink
Portrait 36 · Drawn in ink
Portrait 37 · Drawn in ink
Portrait 38 · Drawn in ink
Portrait 39 · Drawn in ink
Portrait 40 · Drawn in ink
Portrait 41 · Drawn in ink
Portrait 42 · Drawn in ink
Portrait 43 · Drawn in ink
Portrait 44 · Drawn in ink
Portrait 45 · Drawn in ink
Portrait 46 · Drawn in ink
Portrait 47 · Drawn in ink
Portrait 48 · Drawn in ink
Portrait 49 · Drawn in ink
Portrait 50 · Drawn in ink
Portrait 51 · Drawn in ink
Portrait 52 · Drawn in ink
Portrait 53 · Drawn in ink
Portrait 54 · Drawn in ink
Portrait 55 · Drawn in ink
Portrait 56 · Drawn in ink
Portrait 57 · Drawn in ink
Portrait 58 · Drawn in ink
Portrait 59 · Drawn in ink
Portrait 60 · Drawn in ink
Portrait 61 · Drawn in ink
Portrait 62 · Drawn in ink
Portrait 63 · Drawn in ink
Portrait 64 · Drawn in ink
Portrait 65 · Drawn in ink
Portrait 66 · Drawn in ink
Portrait 67 · Drawn in ink
Portrait 68 · Drawn in ink
Portrait 69 · Drawn in ink
Portrait 70 · Drawn in ink
Portrait 71 · Drawn in ink
Portrait 72 · Drawn in ink
Portrait 73 · Drawn in ink
Portrait 74 · Drawn in ink
Portrait 75 · Drawn in ink
Portraits in colour
75 portraits, one picture each. In colour, a portrait never blinks. A working one breathes and tilts, and all of them hold still when you ask for reduced motion.
Portrait 01 · In full colour
Portrait 02 · In full colour
Portrait 03 · In full colour
Portrait 04 · In full colour
Portrait 05 · In full colour
Portrait 06 · In full colour
Portrait 07 · In full colour
Portrait 08 · In full colour
Portrait 09 · In full colour
Portrait 10 · In full colour
Portrait 11 · In full colour
Portrait 12 · In full colour
Portrait 13 · In full colour
Portrait 14 · In full colour
Portrait 15 · In full colour
Portrait 16 · In full colour
Portrait 17 · In full colour
Portrait 18 · In full colour
Portrait 19 · In full colour
Portrait 20 · In full colour
Portrait 21 · In full colour
Portrait 22 · In full colour
Portrait 23 · In full colour
Portrait 24 · In full colour
Portrait 25 · In full colour
Portrait 26 · In full colour
Portrait 27 · In full colour
Portrait 28 · In full colour
Portrait 29 · In full colour
Portrait 30 · In full colour
Portrait 31 · In full colour
Portrait 32 · In full colour
Portrait 33 · In full colour
Portrait 34 · In full colour
Portrait 35 · In full colour
Portrait 36 · In full colour
Portrait 37 · In full colour
Portrait 38 · In full colour
Portrait 39 · In full colour
Portrait 40 · In full colour
Portrait 41 · In full colour
Portrait 42 · In full colour
Portrait 43 · In full colour
Portrait 44 · In full colour
Portrait 45 · In full colour
Portrait 46 · In full colour
Portrait 47 · In full colour
Portrait 48 · In full colour
Portrait 49 · In full colour
Portrait 50 · In full colour
Portrait 51 · In full colour
Portrait 52 · In full colour
Portrait 53 · In full colour
Portrait 54 · In full colour
Portrait 55 · In full colour
Portrait 56 · In full colour
Portrait 57 · In full colour
Portrait 58 · In full colour
Portrait 59 · In full colour
Portrait 60 · In full colour
Portrait 61 · In full colour
Portrait 62 · In full colour
Portrait 63 · In full colour
Portrait 64 · In full colour
Portrait 65 · In full colour
Portrait 66 · In full colour
Portrait 67 · In full colour
Portrait 68 · In full colour
Portrait 69 · In full colour
Portrait 70 · In full colour
Portrait 71 · In full colour
Portrait 72 · In full colour
Portrait 73 · In full colour
Portrait 74 · In full colour
Portrait 75 · In full colour
Built from the grammar
Orb · the assistant
Box · Monday
Gem · Renewals
Spark · Scout
Leaf · Prep
Wave · Follow-through
Owl
Bolt
Beacon
Operator
Ledger
Satellite
Captain
Anchor
Ranger
Quill
Material
Floating, not flat.
Surfaces that overlay the page — popovers, modals, the cue rail’s settings popover — use a translucent layer: backdrop-blur, hairline border, soft shadow. The page below shows through faintly so the rep stays oriented.
Floating example
.wm-floating
Translucent backdrop-blur, hairline border, soft shadow.
The page below.
Notice how the floating card lets the page texture show through. Apple Liquid Glass as restraint-reference. Not a copy.
Voice
Plain, direct, human.
Don’t
- “mcp:list_stalled_deals”
- “Something went wrong”
- “No data”
- “Loading…”
Do
- “Looking up your pipeline…”
- “Couldn’t reach TopLine. Check your connection.”
- “No scorecards yet — run a meeting and this fills in.”
<LoadingRows />— a skeleton in the right shape