Experimental AT protocol email hosting
sovrn DESIGN.md
54 kB · 610 lines
Markdown
at main


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

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 <table> 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 (<Masthead compact />). 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 (<Footer compact />), which mirrors the console brandFooter: its minimum height equals the masthead's (4.5rem, 4rem below 640px), the tagline is 16px, the wordmark has line-height 1, and the corner cell is 11.8% (3rem below 640px). The console's full-bleed LayoutWide is a 100svh flex column too, so its footer also sits flush with the bottom edge.
  • Browser surfaces: the caret and ::selection are tangerine, with white selection text, console-wide. The handle typeahead list is square, paper, framed in 2px PTT, with gold-wash rows and handles in mono.
  • Signed-in home (home.templ, home_view.go): the site world at working scale, with no big colour fields. It's the single 48rem operator column on Cool Paper, organised by rules rather than boxes.
    • .home-title is Schibsted 850 at clamp(2.25rem, 5vw, 3rem), -0.04em, in PTT. .home-lede is 1.0625rem Ink at a 62ch measure.
    • The domain list sits under a 3px PTT head rule, with 1px PTT/25 row rules. Each row carries:
      • the domain name in mono;
      • a plain-language status with a 10px square marker (muted teal = working, PTT haze = waiting, tangerine = needs attention, fog = switched off); gold read as a warning, so success uses muted-teal-500;
      • the user count and a one-line meaning;
      • two actions: "Add a user" (to the domain page's #add-user card) and Settings.
    • The action that unblocks mail in the row's state takes the filled .btn-brand, and the other takes .btn-brand-outline. Both are square, with a 2px PTT border, min-height 3rem and padding 0.625rem 1.25rem. The outline hover is a gold wash, and only the filled one carries the drawn arrow.
    • A help question above the list ("What do the buttons under each domain do?", with the Lucide circle-question-mark icon and a chevron) explains both buttons once. It uses the shadcn-templ collapsible and is closed by default, so it costs one line until asked. Rows keep only a personalised example and the state-specific line.
    • When an owner has more than two domains, rows fold to name, status and user count, with a "Show actions" / "Hide actions" toggle (collapsible, chevron rotates). Rows whose state needs setup or a fix stay open, so blocking work is never hidden.
    • All console JavaScript is one esbuild bundle. static/index.js imports htmx and the Floating UI globals (through globals.js), every shadcn-templ component script, and the console's own modules (app.js, typeahead.js, new_account.js, which export init functions). go generate ./internal/appview/ui builds it to static/dist/index-<hash>.js with esbuild's metadata.json. assets.go embeds both, AssetPath("index.js") resolves the current hashed URL for templates, and /assets/ serves it immutable. A test fails if a component script isn't imported.
    • The "Add a domain" section (also reachable from a header link) explains what adding a domain does and warns about moving existing mail. It previews four numbered steps in a two-column grid, and step 2 shows a DNS record specimen: type block, host, and the value side marked as a placeholder ("the value from your setup page"). It ends with the postal cell field and "Add domain".
    • Plain words throughout: "user", "settings", "the company where you bought the domain". "DNS records" appears once, explained.
  • Signed-in footer (consoleFooter, every Layout page): the landing footer's PTT band and tangerine corner cell at masthead height (4.5rem, 4rem below 640px), carrying the help links Documentation (/docs/, the future Starlight docs) and Support (/support) instead of the wordmark, since the masthead already names the site. Layout is a 100svh flex column, so the footer sits on the bottom edge of short pages.
  • Support page (support.templ, signed-in only):
    • The heavy title and lede, then a form under a 3px PTT rule. It has a subject input and a "What's happening?" textarea, both styled .brand-field (square, 2px PTT border, paper ground, gold-50 focus wash), and a .btn-brand submit button.
    • A note names the handle and account ID that go with the message, then lists "We'll reply to" with every address sovrn hosts for that account (mono). If there are none, it asks for an address in the message. Hidden handle/did fields carry the identity, but the server always uses the session identity and looks up the addresses itself.
    • Errors show in a square coral-bordered alert with the typed text kept. The sent state is a muted-teal rule with a teal check (The Success Rule).
    • Below the form: "Other ways to reach us" (email the support address, or DM @sovrn.at on Bluesky), and a closing 3px-ruled callout pointing feature requests to the public board.
  • Console section and table type: section titles (the home page's "Add a domain", the domain page's "Users" and "Finish setting up this domain") are Schibsted 800 at 1.75rem, -0.03em, in PTT. Email addresses in dense tables are JetBrains Mono at 0.8125rem.
  • Domain page (domain.templ, /domains/{id}, domain administrators): a users-first operator page in the home page's language.
    • Header: a "Your domains" back link led by the Lucide arrow-left icon (18px, centred on the text), the domain name in heavy mono, the status marker and label with the user count, and "Add a user" as the page's single filled button, top right (/domains/{id}/users/new, a future page).
    • DNS:
      • Staged until the first check: a new domain's page is only its DNS setup: no users section, no "Add a user" and no user count, and the setup text ends "When you've added them all, press Check. Then you can add your users." After a check whose only problems are records not found yet (taken to be DNS still propagating), the users section and "Add a user" appear. A record with the wrong value keeps them hidden until a check finds none. A check that changes this reloads the page instead of swapping the records. A domain that already has users, or is verified, always shows them.
      • Record marks: in place is a muted-teal check; not found yet is a tangerine clock with "Not found yet."; a wrong value is a Signal Coral cross (an error, so coral is allowed) with "Found … instead. Correct it, then check again." The status line after a wrong value is coral-ruled and says to correct the records marked with a red cross and check again.
      • Until the domain is verified, setup is the centre of the page, above the users. A "Finish setting up this domain" section holds the records in specimen style (type reversed out in PTT, host and value in mono, click to copy) and a Check outline button. The help text above the table runs its full width.
      • Checking: a new domain isn't checked when it's added: the owner publishes the records afterwards, and a lookup before then leaves "not found" in resolvers for the zone's negative TTL (30 minutes at Cloudflare). The verifier's first check waits verification.firstcheckdelay (30 minutes); the button checks at once and ends that wait. It says "Check" until the owner has pressed it, then "Check again". The status line under it says when the first automatic check runs, then what the last check found ("Last checked 05:41 UTC: 3 of 5 records are in place"), or, once every record is in place but the relay hasn't confirmed its own, that the DNS records are verified and the domain is being configured for email and will be active soon. Copy never mentions the relay or a "sending service": to the owner, sovrn sends their mail. Once a domain has been checked, each record row leads with its mark from the last check (Lucide circle-check in muted teal, circle-x in tangerine, with screen-reader text), and a record not in place says "Not found yet." or "Found instead." under its value in tangerine, so a mistyped record stands out. Checks from the verifier and the button are stored (dns_checks), so the marks survive a reload. A press replaces the records and the line together (htmx); a check that makes the domain ready reloads the page. When our check finds every record, sovrn asks the relay to look again (SMTP2GO's /domain/verify) rather than wait for the relay's own recheck.
      • Records: names are relative to the domain, as DNS providers ask for them: "@" for the domain itself, else the subdomain part (em1284551, s1284551._domainkey). Names never wrap; the Name column takes about 30% of the table from sm and the value takes the rest. MX comes first, one row per exchange (10 <cell hostname>, then any backup). The ownership TXT follows: _sovrn with sovrn-verify=<token>, the claim's random token, which is what proves the owner controls the zone (every other record can be worked out from the domain name). The outbound relay's required records follow (for SMTP2GO, the DKIM and return-path CNAMEs; tracking CNAMEs are left out). sovrn publishes no SPF or DKIM record of its own: every domain sends through the relay, which signs (bug 62aba1d); development uses an in-memory fake relay. Their values are sovrn names, not the relay's: dkim.sovrn.at and return.sovrn.at, which alias dkim.smtp2go.net and return.smtp2go.net, so the relay never appears in the owner's DNS. The verifier stores the relay's records with the relay's own targets, which the readiness check still matches because a CNAME lookup follows the chain to its end. Adding a domain registers it with the relay and waits for the answer, so the page has these records on its first load. If the relay can't answer, SMTP2GO's records are built from the account ID (relay.accountid: every sender domain's selectors are s<ID> and em<ID>). Only a relay with neither shows a tangerine-ruled note that a few records aren't ready yet while the domain is prepared for email. The DMARC TXT follows: _dmarc with v=DMARC1; p=none. The check accepts any one valid DMARC policy, so an owner's existing record (p=reject, report addresses) passes; a relay's own _dmarc record isn't listed again. A domain with a hosted PDS ends the list with *.at CNAME pds.<region>.sovrn.at, the region's PDS, so <user>.at.<domain> handles resolve.
      • Once active, the records fold into the header behind a success status button, "DNS is set up correctly" (muted-teal border, wash and check, per The Success Rule). It uses the collapsible and starts closed, and inside it notes the records are only needed again when changing DNS providers. Its Check again button's status line stays empty until pressed: active domains aren't checked on their own.
    • Users:
      • Under a 3px head rule sit a "Find a user" search field (.brand-field) and a result count (aria-live).
      • The condensed table (about 37px rows) has Surname, Given name, Email address (mono), a plain status (marker plus Active / Setting up / Suspended / Being removed) and a "Settings" link to the user's page. Missing names show an em dash. Below 640px each row collapses to name, address and status with Settings on the right.
      • Pagination is 25 per page, with Previous and Next outline buttons around "Page n of m".
      • Search and paging swap only the users panel via htmx (GET /domains/{id}/users, 300ms debounce) and set HX-Replace-Url, so the address stays shareable. Without JavaScript the same form and links load the full page.
    • Names: they come from each owner's Stalwart contact card (the source of truth; owners edit it over JMAP). sovrnd keeps a disposable contact_cache table refreshed when older than 24 hours, so rendering and search don't wait on Stalwart.