Design System. The Parts Every Page Is Made of.
Tokens, type, components, motion and the rules for combining them. This page renders the real components, so it’s always current; the written version is DESIGN.md.
Brand
Plumb: a plumb line checks that something is true. The mark is a P on the blue tile, cut by a diagonal; hover the logo and the cut opens.
Voice: plain statements of fact. A tool says what it found (“Blocked.”), then why, then what to do. No exclamation marks, no jargon without a definition.
Colour
White, Athens Gray tiles and icon-black ink, after Apple's palette; dark is the visitor's choice. One accent, Electric Blue, for links, focus and the current tool. Status colours never double as the accent.
Surfaces
bgsurfaceraisedmutedfill · fill-hoverline · line-stronginverseInk
inksoftfaintAccent
accentaccent-strongaccent-softon-accentStatus
okwarnbadok-soft · warn-soft · bad-softTokens are CSS variables in app/globals.css (--color-*), used as Tailwind classes: bg-surface, text-soft, border-line. Dark mode redefines the same variables.
Type
Host Grotesk for everything you read, set tight in headlines. Two-tone headlines: a soft lead-in, then the statement in ink. Geist Mono only for data: URLs, rules, codes and compared numbers.
type-displaytype-titletype-sectiontype-tooltype-verdicttype-headingtype-decktext-[0.9375rem]font-monoSpace and Shape
Content sits in a 1280px column with generous section spacing. Two shapes: things you press are pills; things you read are soft panels (28px), tiles (20px) and inputs (14px).
Components
Everything in components/ui.tsx and components/workspace.tsx. Tools compose these; they don't restyle them.
Command Bar
The input a tool runs on, above the fold. Options sit in a row underneath; “/” focuses it; ?url=…&run=1 fills and runs it.
Command Area
Bulk tools. ⌘↵ runs it.
Working
- Fetching robots.txt…
- Matching rules
- Rendering the page
While a tool works: steps advance with time, elapsed seconds on the right.
Empty State
The Verdict
Allowed or blocked for the crawler you pick, or for 32 major crawlers at once, with the exact rule and group.
The File
Syntax errors, misspellings Google forgives, unsupported directives, and the sitemaps it lists. Edit it and see which verdicts change against the live file.
In Bulk
Up to 1,000 URLs or paths against each site's robots.txt or your edited file, with CSV export.
Buttons
Pills. Hover a full-size one: the fill draws in from the edge and the label arcs over to a copy of itself. Press squishes it. Small pills are utilities.
Fields
Choices
Tabs
Chips
Verdict
Blocked.
- URL
- https://www.google.com/search?q=plumb
- Deciding rule
line 3 · Disallow: /search- Group
User-agent: *
Allowed.
No rule matches this URL.
One per result: the answer as a headline in its status colour, the evidence as facts beneath it.
Callouts
Figures
Sections and Panels
The File
1User-agent: *2User-agent: Yandex3Disallow: /search4Allow: /search/aboutPanel
A boxed panel, for forms and editors only.
A panel: a hairline frame with a 28px radius, the title inside. No panels in panels; tiles inside a panel use the grey fill.
Long Lists
- https://example.com/sitemaps/part-1.xml
- https://example.com/sitemaps/part-2.xml
- https://example.com/sitemaps/part-3.xml
- https://example.com/sitemaps/part-4.xml
Results Table
| https://example.com/ | GPTBot | can access | 200 |
| https://example.com/blog/ | ClaudeBot | refused | 403 |
| https://example.com/shop/ | PerplexityBot | can access | 200 |
Motion
One curve family: settle (0.19, 1, 0.22, 1) for hovers and entrances, in-out for large moves, a quick ease-in for exits. Every control answers the pointer; reduced motion turns it all off.
- Pills
The fill draws in, the label arcs over, the arrow slips through; press squishes.
- Glide
One soft pill glides between nav, sidebar and tab items, and rests on the current one.
- Verdict
The status mark pops in on a spring while the title rises from behind a mask.
- Progress
Steps tick off with a check, the current one spins, elapsed time counts up.
- Figures
Numbers roll in digit by digit; bars grow from the left.
- Choices
Checkboxes draw their tick and bounce; radios pop their dot.
- Copy
The icon morphs to a tick, a toast confirms.
- Entrances
Above the fold in CSS from the first paint; below, content rises as it scrolls in.
Principles
How pages are put together.
- Show the product.
Pages open on the tool itself, filled with a real example where there's nothing to show yet.
- Answer first.
A result opens with its verdict and status mark, then the evidence: the rule, the line, the response.
- One accent.
Blue marks links, focus and the current tool. Buttons are ink pills; everything else is grey and white.
- Panels hold results.
Each result is a soft panel; rows inside are separated by hairlines. No panels inside panels.
- Mono means data.
URLs, codes, tokens, numbers and labels are monospace; prose never is.
- Status is semantic.
Green allowed, amber differs, red blocked. Never use a status colour for decoration.
- Dense where it's data.
Tables and code are compact; headlines and verdicts get room to breathe.