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
Form controls and validation
Use the email tied to this account.
Enter all 6 digits.
Status and feedback
Navigation, badge, and avatar
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.
- 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.