Skip to content
Plumb
Light theme onCheck a URL

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.

Plumb

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

White
bg
The page
Surface
surface
Panels, framed by a hairline
Athens Gray
raised
Tiles, inputs, table heads, the command bar frame
Muted
muted
Tile hover
Fill
fill · fill-hover
Secondary pills, the gliding highlight
Line
line · line-strong
Hairlines, panel borders
Icon black
inverse
The closing band, code panels

Ink

Ink
ink
Text, primary pills
Soft
soft
Secondary text, the lead-in of a headline
Faint
faint
Hints, captions

Accent

Electric Blue
accent
Links, focus, the current tool's icon
Blue deep
accent-strong
Hover
Blue tint
accent-soft
Tags, selected chips
On accent
on-accent
Text on the accent

Status

OK
ok
Allowed, valid, passed
Warn
warn
Differs, attention
Bad
bad
Blocked, invalid, failed
Tints
ok-soft · warn-soft · bad-soft
Verdicts, callouts, chips

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

Display
type-display
Host Grotesk 500 · 42 to 80px · -4.5%
Checked the way search engines see it.
Title
type-title
Host Grotesk 500 · 36 to 56px · -4%
robots.txt
Section
type-section
Host Grotesk 500 · 30 to 44px · -3.5%
Every Tool, by What it Checks.
Tool
type-tool
Host Grotesk 500 · 32 to 44px
robots.txt Tester
Verdict
type-verdict
Host Grotesk 600 · 24 to 32px
Blocked.
Heading
type-heading
Host Grotesk 600 · 17px
The file
Deck
type-deck
Host Grotesk 400 · 17 to 20px / 1.45
Check whether a URL is blocked, which rule blocks it and for which crawler.
Body
text-[0.9375rem]
Host Grotesk 400 · 15 to 16px
Rules match the path and query string from the start.
Data
font-mono
Geist Mono · 12 to 15px
Disallow: /search

Space 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).

Input · rounded-xl · 14px
Tile · rounded-2xl · 20px
Panel · rounded-3xl · 28px
Hairline · border-line · separates rows and panels
Strong · border-line-strong · control borders, dashed drop zones

Components

Everything in components/ui.tsx and components/workspace.tsx. Tools compose these; they don't restyle them.

Command Bar

Try

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

2 / 100

Bulk tools. ⌘↵ runs it.

Working

  1. Fetching robots.txt…
  2. Matching rules
  3. Rendering the page
0.0s

While a tool works: steps advance with time, elapsed seconds on the right.

Empty State

1

The Verdict

Allowed or blocked for the crawler you pick, or for 32 major crawlers at once, with the exact rule and group.

2

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.

3

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

alloweddiffersblockedreferenceneutral200301404

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

Google ignores crawl-delay (Bing and Yandex use it).
Submitted: the URLs were received.
Tested the AMP page linked from this URL.

Figures

Checks
140
Can access
96
Blocked
31
Other
13

Sections and Panels

The File

1User-agent: *
2User-agent: Yandex
3Disallow: /search
4Allow: /search/about

Panel

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

3 / 3
https://example.com/GPTBotcan access200
https://example.com/blog/ClaudeBotrefused403
https://example.com/shop/PerplexityBotcan access200

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.

  1. Show the product.

    Pages open on the tool itself, filled with a real example where there's nothing to show yet.

  2. Answer first.

    A result opens with its verdict and status mark, then the evidence: the rule, the line, the response.

  3. One accent.

    Blue marks links, focus and the current tool. Buttons are ink pills; everything else is grey and white.

  4. Panels hold results.

    Each result is a soft panel; rows inside are separated by hairlines. No panels inside panels.

  5. Mono means data.

    URLs, codes, tokens, numbers and labels are monospace; prose never is.

  6. Status is semantic.

    Green allowed, amber differs, red blocked. Never use a status colour for decoration.

  7. Dense where it's data.

    Tables and code are compact; headlines and verdicts get room to breathe.