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.

12 · 30 sec · 4.2% (marks, not reading)
text-micro

11px

Eyebrow · category · 30 sec
wm-text-caption

12px

Secondary text and hints.
wm-text-small

12px

Default body — the workhorse.
wm-text-body

13px

Lead paragraph and kicker copy.
wm-text-body-lg

15px

Card title
wm-text-title-s

18px

Page heading
wm-text-title

22px

Hero moment
wm-text-display-s

28px

You’re ready.
wm-text-display

32px

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.

today
meetings
accounts
watchlist
cadences
documents
pipeline
my-work
assistant
team
leadership
admin
number
growth
practice
alerts
network
voice-note
saved-commands
booking
rocket
deal
engagement
activity
signal
security
plug
sparkle
bolt
inbox
check
chart
people
building
book
clock

Space & 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-14px
wm-space-28px
wm-space-312px
wm-space-416px
wm-space-520px
wm-space-624px
wm-space-832px
wm-space-1040px

Color

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.

What they do
Regional radio group with eleven stations.
Industry
Radio broadcasting
Close date
Mar 3
Moved twice
Owner
Dana Park

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.

2 suggestions waiting for your review

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.

Building this report

sm · 16px

Inline: buttons, chips, one-line strips

TopLine is thinking

md · 20px

A message or a small panel

Loading Accounts

lg · 48px

A whole page loading, with its name

Opening TopLine

hero · 128px

A full-screen cover

Crew faces

A small crew, each with a face.

The assistant and every bot 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

25 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

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

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

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

Portraits

25 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

Portraits in colour

25 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

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