Beta
Claim Handle

Handle design system.

This page is a live reference for tokens and reusable UI patterns used by handle.pub. The source of truth lives in src/styles.css (tokens and shared classes), src/index.js (Worker-rendered components), and this page for examples.

Current UI audit

The public status page uses the compact shell: the same Handle wordmark and theme tokens, and a short footer with company, legal and contact links, the RSS feed, and one theme link. It has no account controls and no section label. The theme link works without JavaScript.

Area Current pattern Observed gap Systemized here
Cards Repeated card and heading class strings in server templates. Harder to update spacing and title scale consistently. feature-card, feature-card-body, feature-card-title.
Menus and lists Menu surfaces repeated with two similar background variants. Variant intent lived only in class strings. menu-surface and menu-surface-muted.
Base tokens daisyUI theme tokens were present but semantic aliases were not. Harder to talk about intent when composing new views. Semantic CSS variables in :root for surface, text, focus, spacing, and shadow roles.
Focus visibility Focus style depended on browser and component defaults. Inconsistent focus visibility across controls. Shared :focus-visible outline in base styles.

Design tokens

Brand colors come from ../handle-brand/README.md. Handle maps those to semantic roles in the daisyUI theme and in CSS variables.

Page surface

--color-base-200

Card and field surface

--color-base-100

Primary action and accent

--color-primary (#3D71E0)

Info and soft status

--color-info

Typography

Body copy uses Hanken Grotesk.

Monospace uses JetBrains Mono.

Radius and border

Field radius: --radius-field (8px)

Box radius: --radius-box (12px)

Border width: --border (1px)

Spacing scale

--space-1 4px

--space-2 8px

--space-4 16px

--space-8 32px

Light and dark themes

Handle has two themes, handle (light, the default) and handle-dark (Catppuccin Mocha). The Worker sets data-theme="handle-dark" on <html> for an account that chose dark, in Settings › Appearance. Every swatch below carries its own data-theme, so both palettes show whichever theme this page is in. Every UI feature supports both: use these tokens and never a hex value. See guides/dark-mode.md.

Token Role Light Dark
--color-base-200 Page background #f8f7f5 #181825
--color-base-100 Cards, fields, header capsule #ffffff #1e1e2e
--color-base-300 Borders and dividers #e7e5e1 #313244
--color-base-content Body text, ink buttons #18181b #cdd6f4
--color-primary Button and badge fills, with a white label #3d71e0 #3d71e0
--color-handle A handle, and accent text #3d71e0 #89b4fa
--color-link Links drawn in a colour of their own, and arrows #3d71e0 #ffffff
--color-info Info status, with a dark label in dark #2e5bbf #89b4fa
--color-success Verified and success #15803d #a6e3a1
--color-warning Caution #b54708 #fab387
--color-error Errors #b42318 #f38ba8

The header's Beta pill uses --header-beta-text: var(--color-info) in light and black (#000000) in dark, on the same pale blue fill.

Not themed: QR codes sit on a white plate in both themes, and photos show as uploaded. The wordmark takes its ink and @ from --logo-ink and --logo-at.

Components and states

Buttons and links

Inline link

Form controls and validation

Use the email tied to this account.

Status and feedback

Saved.
We sent a new code.

Navigation, badge, and avatar

Beta

Profile flair

The handle page avatar: status bubble, badge chips, Markdown action, lock and New, each with a tooltip, then the nameplate, whose badge words show only on a narrow screen. Hover or focus each one. See docs/product-features/profile-flair.md.

View as Markdown
  • Staff: Handle staff
  • Beta User: Joined during the beta

Human · self-declared

Private profile

Profile card

The handle page's Identities, Activity and People cards: a bold title with a muted count or note, the card's buttons, and a hairline under the head. See docs/product-features/linked-identities.md.

Identities 6

The card's rows or text.

Accessibility requirements