--- name: sovrn description: Sovereign ATProto mail hosting with a bright, intuitive operator console. colors: primary: "#364163" primary-foreground: "#ffffff" ring: "#4d66b3" sky: "#7085c2" accent-wash: "#dee2ed" accent-pop: "#fbf1d0" background: "#eef0f6" foreground: "#121621" card: "#ffffff" muted: "#dee2ed" muted-foreground: "#475785" border: "#bdc4db" destructive: "#c31909" chart-2: "#f1560e" chart-3: "#e9b816" chart-5: "#f41f0b" # Marketing site (site/) scope: every site- token applies to site/ only site-gold: "#e9b816" site-gold-wash: "#fbf1d0" site-ptt: "#2e3d6b" site-ptt-deep: "#1f2947" site-ptt-soft: "#b8c2e0" site-signal: "#f1560e" site-paper: "#eef0f6" site-paper-rule: "#bdc4db" site-ink: "#121621" site-ink-soft: "#475785" site-error: "#921207" site-white: "#ffffff" typography: display: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "1.5rem" fontWeight: 700 lineHeight: 1.2 letterSpacing: "-0.025em" headline: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "1.125rem" fontWeight: 600 lineHeight: 1.4 letterSpacing: "-0.01em" title: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "1rem" fontWeight: 500 lineHeight: 1.4 letterSpacing: "normal" body: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "0.875rem" fontWeight: 400 lineHeight: 1.5 letterSpacing: "normal" label: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "0.75rem" fontWeight: 500 lineHeight: 1.4 letterSpacing: "0.01em" site-display: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "clamp(2.3rem, 8.2vw, 7.9rem)" fontWeight: 850 lineHeight: 0.95 letterSpacing: "-0.042em" site-headline: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "clamp(2.25rem, 5.2vw, 5rem)" fontWeight: 850 lineHeight: 0.95 letterSpacing: "-0.04em" site-numeral: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "clamp(4.5rem, 8vw, 7.5rem)" fontWeight: 900 lineHeight: 0.85 letterSpacing: "-0.06em" site-title: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "clamp(1.25rem, 1.7vw, 1.6rem)" fontWeight: 750 lineHeight: 1.1 letterSpacing: "-0.025em" site-lede: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "clamp(1.125rem, 1.45vw, 1.375rem)" fontWeight: 400 lineHeight: 1.45 letterSpacing: "normal" site-body: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "1.0625rem" fontWeight: 400 lineHeight: 1.5 letterSpacing: "normal" fontFeature: "'ss01'" site-label: fontFamily: "Schibsted Grotesk Variable, Helvetica Neue, Arial, sans-serif" fontSize: "0.9375rem" fontWeight: 700 lineHeight: 1.5 letterSpacing: "-0.01em" site-mono: fontFamily: "JetBrains Mono Variable, ui-monospace, SFMono-Regular, Menlo, monospace" fontSize: "0.875rem" fontWeight: 500 lineHeight: 1.5 letterSpacing: "normal" fontFeature: "'zero' 1" site-cells: fontFamily: "JetBrains Mono Variable, ui-monospace, SFMono-Regular, Menlo, monospace" fontSize: "1.625rem" fontWeight: 700 lineHeight: 1 letterSpacing: "calc(2.4rem - 1ch)" fontFeature: "'zero' 1" rounded: sm: "0.375rem" md: "0.5rem" lg: "0.625rem" xl: "0.875rem" pill: "9999px" site-none: "0px" spacing: sm: "8px" md: "16px" card: "16px" section: "32px" site-gutter: "clamp(1rem, 3.3vw, 3.25rem)" site-section: "clamp(4.5rem, 9vw, 8rem)" site-stack: "1.75rem" site-column-gap: "3rem" site-cell: "2.4rem" components: button-primary: backgroundColor: "{colors.primary}" textColor: "{colors.primary-foreground}" rounded: "{rounded.lg}" padding: "8px 16px" height: "32px" button-primary-hover: backgroundColor: "{colors.sky}" textColor: "{colors.primary-foreground}" rounded: "{rounded.lg}" padding: "8px 16px" height: "32px" button-secondary: backgroundColor: "{colors.accent-wash}" textColor: "{colors.primary}" rounded: "{rounded.lg}" padding: "8px 10px" height: "32px" button-outline: backgroundColor: "{colors.background}" textColor: "{colors.foreground}" rounded: "{rounded.lg}" padding: "8px 10px" height: "32px" button-ghost: backgroundColor: "{colors.background}" textColor: "{colors.foreground}" rounded: "{rounded.lg}" padding: "8px 10px" height: "32px" button-link: backgroundColor: "{colors.background}" textColor: "{colors.primary}" rounded: "{rounded.sm}" padding: "0px 0px" input: backgroundColor: "{colors.background}" textColor: "{colors.foreground}" rounded: "{rounded.lg}" padding: "4px 10px" height: "32px" card: backgroundColor: "{colors.card}" textColor: "{colors.foreground}" rounded: "{rounded.xl}" padding: "{spacing.card}" site-button-send: backgroundColor: "{colors.site-ptt}" textColor: "{colors.site-paper}" typography: "{typography.site-title}" rounded: "{rounded.site-none}" padding: "0 1.5rem 0 1.625rem" height: "4.875rem" site-button-send-hover: backgroundColor: "{colors.site-ptt-deep}" textColor: "{colors.site-paper}" rounded: "{rounded.site-none}" height: "4.875rem" site-cell-field: backgroundColor: "{colors.site-gold}" textColor: "{colors.site-ptt}" typography: "{typography.site-cells}" rounded: "{rounded.site-none}" height: "4.625rem" site-machine-tag: backgroundColor: "{colors.site-gold-wash}" typography: "{typography.site-mono}" rounded: "{rounded.site-none}" padding: "0.3rem 0.55rem" site-record: backgroundColor: "{colors.site-paper}" textColor: "{colors.site-ptt}" typography: "{typography.site-mono}" rounded: "{rounded.site-none}" padding: "0.45rem 0.7rem" site-record-type: backgroundColor: "{colors.site-ptt}" textColor: "{colors.site-paper}" rounded: "{rounded.site-none}" padding: "0.1rem 0.4rem" site-exchange-cell: backgroundColor: "{colors.site-ptt-deep}" textColor: "{colors.site-paper}" rounded: "{rounded.site-none}" padding: "clamp(0.75rem, 1.4vw, 1.25rem)" site-exchange-cell-live: backgroundColor: "{colors.site-gold}" textColor: "{colors.site-ptt}" rounded: "{rounded.site-none}" padding: "clamp(0.75rem, 1.4vw, 1.25rem)" site-exchange-hub: backgroundColor: "{colors.site-signal}" textColor: "{colors.site-white}" rounded: "{rounded.site-none}" padding: "clamp(0.75rem, 1.4vw, 1.25rem)" site-tick-box: backgroundColor: "{colors.site-paper}" textColor: "{colors.site-signal}" rounded: "{rounded.site-none}" size: "1.75rem" --- # Design System: sovrn > **Scope.** This file records two visual worlds under one brand (the sovrn name and the pinned `colors.txt` ramps). Everything from Overview through Do's and Don'ts below documents the **admin console** (`internal/appview`, Go templ + shadcn-templ): its rounded-lg corners, soft card lift, and pill badges apply to the console's signed-in operator pages only. The section **Marketing site (site/): Public Post & Telecom** documents the public site (`site/`, Astro). The console now shares parts of the site world, recorded in **Console brand chrome** at the end of the site section: the site faces (Schibsted Grotesk, JetBrains Mono) across the whole console, the masthead and brand footer, and the sign-in / waitlist bands. Frontmatter tokens prefixed `site-` belong to the site; all other tokens belong to the console. ## Overview **Creative North Star: "The Friendly Control Plane"** Sovrn is an operator tool that refuses to look like one. The console keeps the density and honesty of infrastructure software — max-w-3xl column, status badges, copy-to-clip DNS tables — but renders it with modern, well-considered craft: soft layered surfaces, tactile controls, and a smart-blue/french-blue identity with gold, tangerine, and coral pops from the pinned hex ramps in `colors.txt`. Nothing decorative survives without a job; nothing functional ships without warmth. Sovereignty reads as stability (deep smart-blue, strict verification states, mono for DIDs and DNS values). Cheer reads as clarity (french-blue focus and hover, gold accent washes, pill badges, generous whitespace, plain-language empty states). The result is professional and intuitive: a domain admin can go from login to verified DNS without ever wondering what matters on the screen. **Key Characteristics:** - Utilitarian operator first, modern product second — no extraneous information. - Smart-blue depth anchors trust; french-blue brightens focus and interaction; gold/tangerine/coral reserved for highlights and destruction. - Soft layered cards over flat chrome; depth responds to state. - Tactile and confident controls with visible focus and press. ## Colors Smart-on-sovereign: deep smart-blue carries authority, french-blue carries focus and action, gold/tangerine/coral carry highlights and destruction. All values come from the pinned hex ramps in `colors.txt` (smart-blue, french-blue, light-gold, tangerine-dream, vibrant-coral, muted-teal). Muted teal is the success colour: `muted-teal-500` marks things that are working. ### Primary - **Smart Blue 700** (#364163): Primary buttons, links, active accents. White text on top (~9.5:1). The sovereignty signal — stable, portable, DID-first. - **French Blue 500** (#4d66b3): Focus rings, selection, and control outlines (french-blue-300 #94a3d1 in dark mode). The ring accent — never body copy. - **French Sky** (#7085c2): Hover lift, focus glow, and cheerful highlights. Dark-mode ring/sky shifts to #94a3d1 for contrast on navy. - **Smart Wash** (#dee2ed smart-blue-100): Secondary button fills, selected badge washes, muted surfaces. Smart-blue-800 text on top (~9:1). - **Smart Line** (#bdc4db smart-blue-200): Borders, dividers, input strokes, table chrome. ### Neutral - **Smart Paper** (#eef0f6 smart-blue-50): Page background in light mode; foreground ink is smart-blue-900 #121621 (~14:1). - **Card White** (#ffffff): Card surface, popover fill in light mode — lifts off Smart Paper. - **Sovereign Ink** (#121621 smart-blue-900): Headings, body text. - **Muted Slate** (#475785 smart-blue-600): Descriptions, helper copy, `text-muted-foreground` secondary lines. - **Mid Fog** (#9ca7c9 smart-blue-300): Scrollbar thumbs, dark-mode muted text. - **Focus Ring** (#4d66b3 french-blue-500): Focus rings and invalid-ring base. - **Signal Coral** (#c31909 vibrant-coral-600): Destructive actions and form errors only. White text on top (~6:1 light); light-coral fill (#f8786d) with dark text in dark mode. ### Pop accents - **Light Gold** (#fbf1d0 wash / #e9b816 chart / #5d4a09 text): Accent fills, sidebar accents, and chart highlights. Gold wash with deep-gold text (~7:1). - **Tangerine Dream** (#f1560e): Chart-2 and sparing highlights — verification-positive accents, never large surfaces. - **Vibrant Coral** (#f41f0b chart / #c31909 destructive): Chart-5 and destructive states only. ### Named Rules **The Smart-Primary Rule.** Smart-blue-700 owns identity and primary action; french-blue owns rings, focus, and hover; gold/tangerine/coral own highlights and destruction. No accent outside `colors.txt` enters the console. **The Success Rule.** Success status symbols (a working domain, an active account, a check that passed) use muted teal from the pinned `muted-teal` ramp: `muted-teal-500` for solid markers, `muted-teal-100` wash with `muted-teal-800` text for chips and badges (inverted in dark mode). Gold reads as a warning, so it never signals success. This applies to the console and the site alike. **The Rarity Rule.** Saturated blue covers ≤10% of any screen (one primary button, a few links and badges); gold/tangerine/coral appear as single-wash highlights only. Their rarity is the point. ## Typography **Display Font:** Schibsted Grotesk (variable, self-hosted from `/static/fonts/`, Latin + Latin Extended), shared with the marketing site **Body Font:** Schibsted Grotesk (same) **Label/Mono Font:** JetBrains Mono (variable, self-hosted, slashed zero) for DIDs, addresses, DNS values, and codes **Character:** Utilitarian and legible with modern tightness — bold tracking-tight page titles, medium card titles, quiet small-body helper copy. Mono is reserved for machine truth (DIDs, `test2@example.com`, TXT values). ### Hierarchy - **Display** (700, 1.5rem / text-2xl, 1.2, -0.025em tracking-tight): Page titles only (`Your domains`, domain name, address). One per screen. - **Headline** (600, 1.125rem / text-lg, 1.4): Section titles (`DNS records`, `Mailboxes`, `App passwords`). - **Title** (500, 1rem / text-base, 1.4): Card titles (`Add a hosted domain`, `Sign in`), item titles. - **Body** (400, 0.875rem / text-sm, 1.5): Default UI text, card content, table cells, alert bodies. Descriptions render in Muted Slate. - **Label** (500, 0.75rem / text-xs, wide-ish 0.01em): Field labels, badge text (badges render at text-xs), helper footnotes, typeahead items. ### Named Rules **The One-Title Rule.** One Display title per screen; everything else steps down to Headline or Title. **The Mono-Truth Rule.** DIDs, handles-as-identifiers, addresses, and DNS content always render in mono. Human prose never does. ## Layout Single centered operator column: `mx-auto max-w-3xl px-4 py-8` (48rem cap, 16px gutters, 32px top rhythm). Header is a thin trust bar (`border-b border-border bg-card`): `sovrn` wordmark left in semibold tracking-tight, `mail hosting on atproto` qualifier right in small muted text. No sidebar, no marketing chrome. Density is compact but breathable: forms use `flex gap-2` inline (domain add, app-password create) or `flex-col gap-4` stacked (mailbox create); sections stack at `mt-8`; cards offset content at `mt-4` / `mt-6`. DNS and IMAP tables sit in `overflow-x-auto rounded-lg border bg-card` scroll shells so long TXT values wrap (`break-all`) instead of breaking layout. Typeahead dropdowns are absolute popovers (`absolute z-10 max-h-64 overflow-auto`) over the field. Responsive behavior is linear: the column narrows, tables scroll horizontally, the login card (`mx-auto max-w-sm`) stays centered. Spacing rhythm follows Tailwind's 4px base with card padding at 16px (`--card-spacing`) and section rhythm at 32px. ## Elevation & Depth Soft-layered, not flat. Cards lift gently off Smart Paper via a hairline ring plus ambient diffusion; popovers and typeaheads lift higher with a true shadow. Rest is calm — no drop shadows on buttons or inputs. ### Shadow Vocabulary - **Card lift** (`0 1px 2px rgb(18 22 33 / 0.08), 0 4px 16px rgb(54 65 99 / 0.08)`): Default card and bordered table shells. Barely-there blue tint keeps paper-on-paper depth cool. - **Popover lift** (`box-shadow: 0 8px 24px rgb(18 22 33 / 0.16)`): Typeahead listboxes, dropdown menus. Observed as `shadow-lg` on `bg-popover border rounded-md` elements. - **Focus halo** (`0 0 0 3px rgb(77 102 179 / 0.5)`): Keyboard focus on buttons and inputs via `focus-visible:ring-3 ring-ring/50`. French-blue, always visible. ### Named Rules **The Flat-By-Default Rule.** Buttons and inputs are flat at rest. Shadow appears only as a response to layer (card, popover) or state (hover lift, focus halo). **The Blue-Shadow Rule.** Large ambient shadows carry a whisper of harbour blue, never pure black. Depth feels cool and bright, not heavy. ## Shapes Friendly-rectangular with one playful exception. Base radius is `--radius: 0.625rem` (10px): buttons and inputs at large (8px height, `rounded-lg`), cards at extra-large (14px, `rounded-xl`), DNS/table shells at large. Small buttons and icon buttons step down proportionally (`rounded-[min(var(--radius-md),10px)]`). Borders are 1px Smart Line throughout; cards add `ring-1 ring-foreground/10` for soft edge definition on white. Badges are the deliberate contrast: full pills (`rounded-4xl` / 9999px, h-5, px-2) for status and DNS-type chips. No clipping, no angled geometry, no sharp-zero corners except the sr-only login heading. ## Components ### Buttons Tactile and confident: solid harbour-blue primary with light-blue hover, 1px press-down, always-visible focus halo. - **Shape:** Gently rounded rectangles (8px radius, `rounded-lg`), default h-8 with px-4; sm h-7, xs h-6, lg h-9 px-4; icon variants square (size-6/7/8/9). - **Primary:** Smart-blue-700 fill, white text (`bg-primary text-primary-foreground`), medium weight, `transition-all`. Padding 8px 16px. - **Hover / Focus:** Hover shifts toward french-blue (`hover:bg-primary/80` resolved toward french-blue-400); focus shows 3px french-blue halo (`focus-visible:ring-3`); active presses 1px (`active:translate-y-px`). - **Secondary:** Smart Wash fill with smart-blue-800 text; hover deepens 5% via color-mix. - **Outline:** 1px Smart Line border on card white, hover to muted wash. - **Ghost:** Borderless, hover to muted wash (used for Sign out and every Manage row action — never Link, so row actions read as buttons on hover instead of underlining). - **Destructive:** Tinted red wash (`bg-destructive/10 text-destructive` light; dark-red text on light-red in dark mode), hover to `/20`. - **Link:** Smart-blue-700 text with underline offset, hover underline (used for Back navigation only). ### Inputs / Fields Quiet boxes that glow blue on focus. - **Style:** Card-white fill, 1px Smart Line stroke, 8px radius, h-8 with px-2.5; base-to-sm text; muted placeholder. - **Focus:** Border shifts to french-blue ring with 3px halo ring (`focus-visible:border-ring focus-visible:ring-ring/50`). - **Error / Disabled:** Invalid shows Signal Coral border + coral halo; disabled dims to 50% opacity with muted fill and not-allowed cursor. ### Cards / Containers Soft layered homes for each task (sign-in, domain add, mailbox add, lists). - **Corner Style:** Extra-large rounding (14px, `rounded-xl`). - **Background:** Card White with `ring-1 ring-foreground/10` hairline. - **Shadow Strategy:** Card lift at rest; no hover shadow (cards are not clickable). - **Border:** 1px Smart Line via ring rather than border property. - **Internal Padding:** Card spacing scale (16px default, 12px in `sm` size); header/content share `--card-spacing` gutters; footer gets muted wash with top border. - **No nesting:** Domain and mailbox lists render as bare `item.Group` rows — never a Card wrapped around outline Items. One box level per list. ### Chips Cheerful status pills, never shouty. - **Style:** Pill silhouette (9999px), h-5, px-2, text-xs medium; secondary variant is muted wash with ink text (`bg-secondary text-secondary-foreground`). - **Active state:** `active` renders on a muted-teal wash with deep-teal text (`bg-muted-teal-100 text-muted-teal-800`, dark-mode inverse), the success colour (see The Success Rule). All other statuses (`verifying`, `claimed`) stay on the secondary wash. - **State:** Status and DNS-type chips are non-interactive by default; linkable chips deepen wash on hover (`hover:bg-secondary/80`). ### Navigation A single trust bar, not a nav system. - **Style:** `border-b bg-card` header, 48rem centered row, wordmark `text-lg semibold tracking-tight` left, qualifier `text-sm muted` right. No tabs or sidebar in v1; in-page navigation is Back link buttons and Ghost Manage buttons plus accordion triggers for verified-DNS detail. ### Tables Bordered readout shells for DNS records and IMAP settings. - **Style:** `rounded-lg border bg-card` wrapper with `overflow-x-auto`; header row small muted; cells small body with mono for copyable values (`break-all`, click-to-copy). - **DNS table:** Type column renders as secondary pill badges; Name/Content columns render as copyable mono codes. ### Alerts / Empty states - **Alerts:** Bordered cards (`rounded-lg border px-2.5 py-2 text-sm`); default paper with ink text; destructive variant pale-red wash with dark-red text. Used for flash messages and form errors (`#form-error` via HTMX swap). - **Empty states:** Centered muted compositions (title + description, e.g. `No domains yet / Add one to start receiving mail`), no illustration in v1. ## Do's and Don'ts Concrete guardrails grounded in the shadcn base-nova implementation and the Friendly Control Plane direction. ### Do: - **Do** keep one primary action per card (Add, Create, Recheck, Continue) in Smart-blue-700 with white text. - **Do** render DIDs, addresses, and DNS Name/Content values in mono with `break-all` and click-to-copy where shown. - **Do** use pill badges for every status: `active` on the muted-teal success wash, `verifying` / `claimed` and DNS types (`MX`, `TXT`, `DKIM`) on the secondary wash. - **Do** keep the `max-w-3xl` centered column and `mt-8` section rhythm on every admin page. - **Do** show the focus halo on every interactive element; verify keyboard reach on mailbox and app-password forms. - **Do** use HTMX inline swaps (`hx-post` + `#form-error` / `#mailbox-list` / `#app-password-result`) so operators never lose table context. ### Don't: - **Don't** introduce any accent outside `colors.txt`, and don't use Vibrant Coral outside destructive/error/chart states. - **Don't** put saturated blue on large surfaces — cards stay Card White and page background stays Smart Paper. - **Don't** invent sidebar, marketing hero, or dashboard-grid layouts inside the signed-in console; the single column is the product. The signed-out sign-in and waitlist pages are the exception: they use the site's gold-field band (see Console brand chrome). - **Don't** ship buttons or inputs without a visible focus state, and don't remove the 1px press translation on primary buttons. - **Don't** render machine identifiers (DIDs, TXT values, ports) in proportional sans — mono is the contract. - **Don't** fabricate brand assets, testimonials, pricing, or benchmark claims; PRODUCT.md confirms none exist. ## Marketing site (site/): Public Post & Telecom Scope: `site/` (Astro; `site/src/styles/global.css` custom properties, `site/src/pages/index.astro`, `site/src/components/WaitlistForm.astro`). Tokens are the `site-` entries in the frontmatter. The console's shared brand chrome (faces, masthead, footer, sign-in bands) and its redesigned signed-in home follow this section, as recorded in **Console brand chrome** at its end; console pages not yet redesigned (domain detail, account) still use the rules above. The Mono-Truth Rule holds in both worlds. ### Overview **Creative North Star: "Public Post & Telecom"** The site presents sovrn as public infrastructure, with the dignity and legibility of a 1970s European PTT identity programme. It is built from flat solid colour fields locked to a hard modular grid: a light-gold field, PTT-blue columns and strips, tangerine signal cells, and cool paper between them. Controls are postal-form objects: boxed character cells, square buttons, tick boxes. Content sits on printed rules instead of in cards. The composition works in full-bleed bands, each one a single field colour. Gold carries the offer and the call to action (hero, close). PTT blue carries proof (the independence strip, the ledger). Deep PTT carries the ecosystem (the exchange). Paper carries the reading sections (schedule, region, steps). Narrow right-hand columns in blue, with tangerine corner cells, repeat on every band. They work as the programme's recurring signature, the way a livery stripe recurs across vehicles and forms. **Key Characteristics:** - Flat solid fields on a hard modular grid; bands, columns and corner cells instead of cards. - One heavy, tight neo-grotesque for everything human; mono only for machine truth. - Postal-form controls: boxed character cells, square buttons, ruled tick boxes. - Zero radius, no shadows; depth comes only from adjacent colour fields. - Tangerine is a signal, never a surface. ### Colors Four field colours from the pinned ramps, with paper and ink neutrals. Every value is declared as a custom property on `:root` in `site/src/styles/global.css`, and each one maps to a `colors.txt` step. #### Primary - **PTT Blue** (`site-ptt`, french-blue-700): The site's voice colour. Used for the wordmark, nav, headlines on paper and gold, the send button, hero and close columns, the independence strip, the ledger band, and the 3px head rules. On dark bands it becomes the ground, with paper text. - **Deep PTT** (`site-ptt-deep`, french-blue-800): Ground of the Atmosphere exchange band and its cells, and the send button's hover and disabled fill. - **PTT Haze** (`site-ptt-soft`, french-blue-200): Secondary text on blue grounds (ledger "them" column, exchange cell lines, footer line), 1px exchange cell borders, route and trunk strokes. Ledger row rules use it at 35% (`color-mix`). #### Secondary - **Field Gold** (`site-gold`, light-gold-500): The offer field. Used for the hero and close fields, the land on the hosting map, the live exchange cell, the live route, and "ours" headers on dark. It carries PTT Blue text (about 5.7:1). It is also the page `theme-color`. - **Gold Wash** (`site-gold-wash`, light-gold-100): Ground of the machine tag, and the cell field's focus wash at 45%. #### Tertiary - **Signal Tangerine** (`site-signal`, tangerine-dream-500): Used only as a signal. Appears in the emblem cell, the chain and footer corner cells, the identity hub, hover and focus routes and cell strokes, the tick mark, the caret, and selection. #### Neutral - **Cool Paper** (`site-paper`, smart-blue-50): Page ground, masthead, and text on blue. - **Paper Rule** (`site-paper-rule`, smart-blue-200): The 1px row and column rules in paper sections. - **Ink** (`site-ink`, smart-blue-900): Body copy on paper. - **Ink Soft** (`site-ink-soft`, smart-blue-600): Ledes and form labels on paper. - **Form Error** (`site-error`, vibrant-coral-700): Invalid cell-field border and outline, and error status text. About 4.9:1 on gold. - **White** (`site-white`): Text on Signal Tangerine (hub), and selection text. #### Named Rules **The Field Rule.** Each band is one solid field colour, edge to edge. Nothing sits on a field except type, rules and postal-form controls: no cards, tiles or panels. **The Signal Rule.** Tangerine marks where the eye should land or where something is connected: corner cells, the hub, the hover route, the tick. It never fills a reading band or carries body text. **The Pinned Ramp Rule.** Every site colour is a step of `colors.txt`. The site draws from different steps than the console (french-blue-700 and 800 as the voice), but it adds no new hues. ### Typography **Display Font:** Schibsted Grotesk Variable (self-hosted via `@fontsource-variable`, with Helvetica Neue and Arial as fallbacks), with `ss01` on body. **Body Font:** Schibsted Grotesk Variable. **Label/Mono Font:** JetBrains Mono Variable, with slashed zero (`'zero' 1`). **Character:** One heavy, tight neo-grotesque does all the human speaking. Weights run 650 to 900 and tracking tightens as size grows. Mono is the typeface of machine records, not a decorative accent. #### Hierarchy - **Wordmark** (900, clamp(2.5rem, 5.9vw, 5.6rem), -0.065em): The lowercase `sovrn` in PTT Blue. Footer repeat at 1.75rem. - **Display** (`site-display`): The hero headline, set as three forced lines. The close title uses the same cut slightly smaller (clamp(2.75rem, 7.5vw, 7.25rem), 0.93). - **Headline** (`site-headline`): Section titles, with `text-wrap: balance`. - **Numeral** (`site-numeral`): Step numbers, printed large in PTT Blue. - **Title** (`site-title`): Schedule terms, ledger row heads (750), step and exchange-cell titles (800). - **Lede** (`site-lede`): Section introductions, max 38ch, `text-wrap: pretty`. - **Body** (`site-body`): Running copy, max 34 to 44ch. - **Label** (`site-label`): Ledger column heads, form-figure labels, status lines. - **Mono** (`site-mono`): DIDs, addresses, protocol lists, DNS records, regions. #### Named Rules **The Mono-Truth Rule (shared).** Only machine truth renders in mono: identifiers, addresses, record types, region values, and the typed email in the cell field. Human prose never does. **The Heavy-and-Tight Rule.** Anything above body size sets at 750 or heavier with negative tracking (-0.025em to -0.07em). Light display weights are outside this world. ### Layout The page is a stack of full-bleed bands, with a gutter of `site-gutter`. The first viewport locks to a grid: a paper masthead with a tangerine emblem column (13.3%), a gold hero field beside a PTT column (24.6%), then the navy independence strip with a tangerine corner cell (11.8%). The close band and footer repeat the column and corner. Reading bands run a 5fr/7fr split, heading left and content right, with `site-column-gap` between. They pad vertically at `site-section`, and inner stacks gap at `site-stack`. The schedule heading is sticky beside its list. The exchange is a 3×3 grid of equal modules with the identity hub in the centre, and routes drawn from the hub to each cell. Responsive: at 1100px and below, 5/7 splits and the region band collapse to one column. The hero and close postmark columns are hidden at 1100px and below. At 800px and below, the masthead stacks, corner cells shrink to 3rem, the ledger becomes labelled stacked rows, steps stack with bottom rules, and the exchange becomes a vertical trunk with one branch per cell, hub first. The cell field tightens its cell module (2.4rem to 2rem at 1400px, 1.25rem at 640px). ### Elevation & Depth Flat. No `box-shadow` creates elevation anywhere on the site. Depth comes only from adjacent field colours and from rules. One inset 2px Signal stroke (`inset 0 0 0 2px`) thickens an exchange cell's border on hover or focus. It is a heavier rule, not a lift. **The No-Lift Rule.** Nothing floats. Hover and focus change stroke colour or weight, fill, or route; they never add shadow or translate upward. The send button's 1px press-down is the only motion on the z-axis. ### Shapes Every corner is square (`site-none`), and form controls set `border-radius: 0` explicitly. The shape language is fields and rules. A 3px PTT rule heads every list and form figure (schedule, region form, steps; 3px Paper on the dark ledger head). 1px Paper Rule lines divide rows and step columns, and 1px strokes box postal controls. Gradients appear only as a ruling device: the cell field's dotted dividers, the nav's 2px underline, and the mobile exchange trunk. They are hard-stopped lines, never colour blends. **The Rule-Not-Box Rule.** Group content with a heavy head rule and hairline row rules, not with a container. A bordered box belongs only to a control or a machine record (cell field, tick box, DNS record, exchange cell). ### Components #### Cell field (waitlist email) A postal-form entry box. Each typed character lands in its own ruled cell. - **Build:** A 2px PTT border, and a repeating vertical rule every `site-cell` (1.5px). Mono 700 with `letter-spacing: calc(cell - 1ch)`, so one character advances exactly one cell. Width rounds down to a whole number of cells (`round(down, …)`), 20 cells max. Sits on gold. - **Focus:** A 3px PTT outline offset 3px, with the Gold Wash at 45% filling behind the cells. - **Error:** The border and outline turn Form Error. A polite live status line below carries plain-language messages in Label weight. #### Square button (send) - **Shape:** Square corners, a PTT fill, Paper text, Schibsted 700 at 1.5rem, and height matched to the cell field (4.875rem). A drawn SVG arrow sits at the trailing edge. - **Hover / Active / Disabled:** Hover fills Deep PTT and the arrow travels 0.35rem. Active presses 1px. Disabled holds Deep PTT with a default cursor. #### Masthead nav PTT text at 650 with tight tracking, and middle-dot separators. On hover, a 2px underline draws in from the left (`background-size`, 0.35s `ease-out`). No pills, no active tabs. #### Colour-field grid (bands, columns, corner cells) The page's structural component. A band is one field colour. It can carry a narrow right column (PTT, holding the speed-mark plate) or a tangerine corner cell. The speed-mark plate (`/plates/speedmark.png`) sits on its field with `mix-blend-mode: lighten`, so only the bars show. The masthead emblem is the vector brand mark (`/brand/sovrn-emblem.svg`), inlined so it takes the cell's paper text colour. The favicon set (`/favicon.svg`, `/favicon.png`, `/apple-touch-icon.png`) is the same mark centred on a tangerine tile. The hero speed-mark enters once ("dispatch", 1.1s: clip and slide from the left), and it is skipped under reduced motion. #### Service schedule A ruled definition list. A 3px PTT head rule, then rows split term | body, each with a mono machine tag and a 1px Paper Rule underneath. #### Machine tag Gold Wash ground, mono 500 at 0.875rem, square, with `0.3rem 0.55rem` padding. It carries the machine-readable version of each provision (`imap · smtp · jmap`, `spf · dkim · dmarc: strict`). Text must reach 4.5:1 on the wash. See the note in Do's and Don'ts. #### Ledger table A real `` on the PTT band. Column heads in Label weight: PTT Haze for "them" and Field Gold for "ours", over a 3px Paper rule. Row heads in Title weight. "Them" cells in PTT Haze, "ours" cells in Paper at 650. Rows divide with 35% Haze rules. Below 800px it becomes stacked rows, each value labelled by a generated caption. #### Ruled exchange cells A 3×3 module grid on Deep PTT. Cells are square, with a 1px Haze stroke, a Title-weight name, and a Haze line. The live service cell is filled Field Gold with PTT text. The identity hub is filled Signal Tangerine, with a larger title and the handle in mono. SVG routes run hub to cell at 28% Paper, with the live route in gold. On hover or focus of any cell, its route turns Signal at full opacity and a heavier weight, and the cell's stroke turns Signal (2px inset). On mobile, the routes become a Haze trunk with 1rem branches. #### Printed tick specimen A form figure under a 3px PTT rule, with a label in Ink Soft. Each option has a 1.75rem square box with a 1px PTT stroke. The selected box carries a drawn SVG cross in Signal Tangerine, like a pen mark on a printed form. The option title is PTT at 1.25rem, with an Ink explanation. #### DNS record specimen An inline mono record with a 1px PTT stroke, square. The record type is reversed out in a PTT block with Paper text (`MX`). #### Independence strip A PTT band under the hero with three benefit statements (data ownership, data location, independent infrastructure). Each has a 3px gold head rule, a paper headline in Schibsted 750 and a PTT Haze line, set in three equal columns, with a tangerine corner cell. It stacks to one column on mobile. It states benefits in plain language: marketing surfaces never show protocol identifiers (DIDs, handle mappings). #### Hosting map The region band's left cell is a map of Europe, drawn at build time from Natural Earth (world-atlas 50m) with a conic conformal projection and inlined as SVG, with no map runtime. Water is PTT Blue and land is Field Gold, with 1px PTT borders: water stays blue so the map never reads as a negative. The hosting countries (Germany, Finland) are Signal Tangerine. Each has a paper square pin and a paper tag with the country name and "EU · GDPR". One "Other regions worldwide" tag sits low in the frame. No route or connection lines: lines to some locations but not others imply uneven connectivity. The canvas (1000×860) is wider than the cell and cropped with `slice`, so only empty ocean and periphery are lost. Tag type is held at a fixed on-screen size whatever size the map renders: a small script reads the map's rendered scale and sets `--label-scale`, so the country name lands at 17px on desktop, 15px at ≤1100px and 13.5px at ≤640px (the note follows at 16/22 of that). Pins and tags scale around their own anchors. Fixed scales (1.2×, 1.35×, 1.6×) are the no-JS fallback. Tags are fitted to their text with equal side padding. Never show the whole world; keep the frame on Europe. The map is set as a printed plate: inset on the paper band with section padding and a 1px PTT hairline frame at a 0.625rem offset (0.375rem at 800px and below), so its blue water never touches the blue ledger and ecosystem bands around it. #### Postmark column The blue hero and close columns, with the speedmark plate, appear only above 1100px. Below that the gold field runs full width and the column is hidden, never restacked as a band. #### Cell field dividers The waitlist field keeps its 2px PTT frame, but the cell dividers are dotted ticks (2px on, 3px off) at 40% ink, inset 0.9rem from top and bottom. They suggest the form without competing with the typed text. The field always ends on a whole cell. ### Do's and Don'ts #### Do: - **Do** build every section as one full-bleed field colour, and group content with a 3px head rule and 1px row rules. - **Do** keep every corner square (`site-none`), including form controls, which must reset `border-radius: 0`. - **Do** set every human word in Schibsted Grotesk, at 750 or heavier with negative tracking above body size. Set identifiers, addresses, records and regions in JetBrains Mono. - **Do** keep tangerine for signals: corner cells, the hub, hover and focus routes, the tick mark. - **Do** match the square button's height to the cell field it sends, and keep its 1px press. - **Do** show focus on every control: a 3px PTT outline offset 3px on paper and gold, and a 3px Field Gold outline inside `.on-dark` bands. - **Do** gate the entrance motion and smooth scrolling behind `prefers-reduced-motion`. #### Don't: - **Don't** add `box-shadow` for elevation, or translate anything upward on hover. - **Don't** use gradients as colour blends. `linear-gradient` is allowed only as a hard-stopped ruling device (cell rules, underline draw, trunk). - **Don't** wrap content in cards, tiles or rounded panels. Bordered boxes are only for controls and machine records. - **Don't** set prose, headings or buttons in mono, or machine values in the sans. - **Don't** put small text (under 1.25rem bold) in White on Signal Tangerine (about 3.4:1). Only the hub's large title may sit there. - **Don't** set machine-tag text in light-gold-700 (#8c6e0d) on Gold Wash (about 4.3:1, under AA at 14px). Use a darker pinned step, such as light-gold-800 (#5d4a09), which is the console's gold pairing. - **Don't** use a colour outside the pinned `colors.txt` ramps. - **Don't** carry console patterns (rounded-lg controls, card lift, pill badges) onto the site. ### Console brand chrome The server-rendered console (`internal/appview/ui`, templ + Tailwind) carries the site world into its shared chrome and its signed-out pages, at console scale. Tokens come from the same pinned ramps (Tailwind `french-blue-700` = site PTT, `light-gold-500` = site gold, `tangerine-dream-500` = site signal, `smart-blue-50` = site paper). - **Faces:** Schibsted Grotesk and JetBrains Mono replace the system stacks across the whole console (`--font-sans` / `--font-mono` in `static/input.css`). The woff2 files are self-hosted from `static/fonts/` (embed.go), preloaded, with Latin and Latin Extended subsets only. - **Masthead (every page, `layout.templ`):** the site masthead at console scale. The heavy "sovrn" wordmark (900, -0.065em, 2.25–2.625rem) sits on paper, and the tangerine emblem cell closes the right edge (4rem, or 5.5rem from `sm`). The inline vector emblem comes from the embedded site build (`site.Emblem()`). Adaptations from the site, recorded deliberately: - The emblem cell is a fixed width, not 13.3%. - The masthead drops the site's anchor nav (the console has no in-page sections). - A 2px PTT rule runs under the masthead, because signed-in pages sit paper on paper with no field change to separate them. - **User chip:** square. It has a square avatar with a PTT fallback cell, the bold name in PTT and the handle in mono. The name is capped at 6rem below `sm` so the chip never reaches the emblem cell. Its dropdown is a square paper panel with a 2px PTT frame, no shadow, and gold-wash item focus. - **Gutter:** the wordmark, the sign-in field content and the footer share the site gutter, `clamp(1rem, 3.3vw, 3.25rem)`, so they align on one left edge. - **Sign-in and waitlist (`login.templ`, full-bleed via `LayoutWide`):** a miniature of the site hero. A gold field holds an 850-weight title at `clamp(3rem, 7vw, 6rem)` and a bold subhead. Below them is the form: the site's postal cell field (`.cell-field`, a real input with mono 700 letter-spaced into whole cells and dotted cell ticks, still driving the handle typeahead) and a square PTT "Continue" button with the drawn arrow. - A 3px PTT head rule caps the note (sign-in) or the permission ledger (waitlist). The ledger lists exactly what the waitlist OAuth flow requests. - A 24.6% PTT column carries the speed-mark plate from 1024px up. - All type on gold is PTT. - The brand footer strip closes the page. - **Site pages with a single task** (`/waitlist/thanks/`) use the compact variant of the site `Masthead` (``). It mirrors the console masthead exactly: no section nav, 4.5rem tall (4rem below 800px), a 2.625rem wordmark (2.25rem below 800px), a 5.5rem emblem cell (4rem below 800px) and the 2px PTT rule. On short pages the footer stays on the bottom edge: the page is a 100svh flex column and the gold field grows to fill it. Those pages also use the compact `Footer` (`