SP Mail Next — design system (« SP Mail Premium »)
One specification for Web (CSS custom properties in web/src/styles/tokens.css), macOS and iOS/iPadOS (Sources/Shared/Design/). It refines the existing identity — warm paper neutrals and the deep green accent — instead of replacing it. The navigation structure (sidebar → list → reader, settings, studio, admin) does not change.
1. Principles
- Content first. Mail is the interface. Chrome recedes: hairline separators, no boxed panels inside panels, one accent colour used for selection, unread and the primary action only.
- Calm surfaces. Translucency is reserved for chrome that floats above content (sidebar on macOS/iPadOS, toolbars, command palette, popovers, toasts). Never behind reading text, never stacked. No decorative gradients.
- Speed is a feature. Every animation is ≤ 240 ms, interruptible, driven by transform/opacity only, and disappears under reduced motion. No animation may delay an action.
- Same components, native feel. Same tokens, names and behaviours on the three platforms; each platform keeps its own controls, materials and typography conventions.
- Accessible by construction. Text contrast ≥ 4.5:1 (≥ 3:1 for large text and icons) in all three themes; focus always visible; targets ≥ 40 px (web desktop), ≥ 44 pt (touch); full keyboard and VoiceOver paths; Dynamic Type on Apple;
prefers-reduced-motion,prefers-contrastand Reduce Transparency honoured.
2. Themes
Three themes, selectable per device, plus « System » (follows light/dark): Light (paper), Dark (graphite), Midnight (true black, OLED, lowest glare). Token names are shared; Swift uses SPColor.<name>.
| Token | Light | Dark | Midnight | Use |
|---|---|---|---|---|
bg |
#f6f5f1 |
#141513 |
#000000 |
window background, list background |
surface |
#ffffff |
#1c1d1b |
#0b0c0b |
reader, cards, inputs |
surface-2 |
#f0eee8 |
#242523 |
#131412 |
hover, sidebar (opaque fallback), quoted blocks |
surface-3 |
#e6e3db |
#2e2f2c |
#1c1d1b |
pressed, chips |
border |
#e2dfd6 |
#2f302d |
#1f201e |
hairlines (1 px / 0.5 pt) |
border-strong |
#c4c0b4 |
#4a4b47 |
#3a3b38 |
inputs, focusable outlines at rest |
text |
#1c1b19 |
#eceae4 |
#e6e4de |
primary |
text-2 |
#4d4a44 |
#b9b6ae |
#a9a69e |
secondary |
text-3 |
#66625b |
#98958d |
#8f8c84 |
tertiary, metadata (still ≥ 4.5:1 on bg) |
accent |
#2c5b4d |
#7cc4ae |
#86cdb7 |
selection, unread dot, primary button, links in chrome |
accent-strong |
#1f4439 |
#9ad6c2 |
#a2dcc9 |
hover/pressed of accent |
accent-soft |
#e0ece7 |
#1f332d |
#12231e |
selected row, soft badges |
on-accent |
#ffffff |
#0c1f19 |
#06140f |
text on accent |
danger / -soft |
#a8231c / #fbe8e6 |
#ff8a80 / #3a1b18 |
#ff8a80 / #2a100e |
destructive, failures |
warn / -soft |
#7a4d00 / #fcefd2 |
#f0c36a / #33290f |
#f0c36a / #241c08 |
warnings, held/undo |
ok / -soft |
#1b6236 / #e0f2e6 |
#7fd39a / #16301f |
#7fd39a / #0e2114 |
delivered, healthy |
info / -soft |
#1d4f91 / #e6eef9 |
#8fb8f0 / #172941 |
#8fb8f0 / #0f1c2e |
informational, AI surfaces |
star |
#b07a00 |
#e6b84d |
#e6b84d |
starred, pinned |
focus |
#1a6dd6 |
#6aa9ff |
#6aa9ff |
focus ring (2 px, 2 px offset) |
glass |
rgba(246,245,241,.72) |
rgba(28,29,27,.68) |
rgba(8,9,8,.72) |
translucent chrome (blur 20 px, saturate 1.4) |
overlay |
rgba(20,19,17,.42) |
rgba(0,0,0,.55) |
rgba(0,0,0,.66) |
scrims |
Label colours (user labels) come from a fixed palette of 10 hues, each with a light and a dark variant chosen for ≥ 4.5:1 as text on its soft background: #b3261e #a14a00 #7a5c00 #2e6b2e #00695c #1d5fa8 #4a4fb5 #7a3fa0 #a8327a #5c5f66.
The HTML of a received message always renders on a white sheet in Light and, in Dark/Midnight, on a white sheet by default with a per-message toggle « Dark reading » that applies a colour inversion filter preserving images (opt-in preference darkMessages).
3. Typography
System fonts only (San Francisco on Apple; the existing system stack on the web). No web fonts are downloaded.
| Role | Web | Apple (Dynamic Type style) | Weight |
|---|---|---|---|
| Display (empty states, dashboard numbers) | 28/34 | .largeTitle |
700, tracking −0.02em |
| Title (reader subject, page titles) | 20/26 | .title2 |
650 |
| Headline (sender in list, section titles) | 15/20 | .headline |
600 |
| Body (message list subject, UI text) | 15/22 | .body |
400 (unread: 600) |
| Callout (preview lines, secondary) | 13.5/19 | .callout / .subheadline |
400 |
| Caption (dates, counters, badges) | 12/16 | .caption |
500, tabular numbers |
| Mono (headers, code, Sieve) | 13/19 | .body.monospaced() |
400 |
Reading text of a plain-text message: 16/26, max line length 72ch. User preference Text size: small / default / large / extra large (web: scales --fs-* by 0.92 / 1 / 1.08 / 1.18; Apple: Dynamic Type is the source of truth, no custom scale). Preference Reading font: system / serif (ui-serif, New York) / mono.
4. Space, shape, elevation, motion
- Spacing scale (px/pt): 2, 4, 6, 8, 12, 16, 20, 24, 32, 40, 56. Row padding 12×16 (comfortable), 8×12 (compact).
- Density: comfortable (row 72), cozy (60), compact (44, single line). Touch platforms never go below 44 pt targets.
- Radii: 6 (chips, inputs), 10 (buttons, rows, cards), 14 (dialogs, sheets, command palette), 999 (pills, avatars). Selected rows are inset, rounded 10, with
accent-softfill — not full-bleed bars. - Elevation: level 0 flat; level 1
0 1px 2px rgba(20,19,17,.06)(cards); level 20 8px 28px rgba(20,19,17,.14)(popovers, palette, toasts); level 30 24px 64px rgba(20,19,17,.22)(dialogs). Dark/Midnight: shadows are replaced by a 1 pxborder+ lighter surface. - Motion: durations 120 ms (hover/press), 180 ms (popovers, list insert/remove), 240 ms (pane and sheet transitions); easing
cubic-bezier(.2,.7,.2,1); Apple:.snappy(duration: 0.24)/.smooth(duration: 0.18), always interruptible springs. List changes animate position, never block input. Reduced motion → opacity cross-fade ≤ 100 ms or none.
5. Iconography and micro-interactions
- Web: the existing inline SVG set (24×24, stroke 1.75, round joins) is extended, never mixed with another family. Apple: SF Symbols,
.symbolRenderingMode(.hierarchical), weight matching the text beside it. - Micro-interactions (all optional under reduced motion): star/pin « pop » (scale 0.9 → 1), unread dot fade, archive/trash row collapse with the row sliding under its neighbour, send button morphing into the undo countdown ring, check-all tri-state, drag preview showing a count badge, drop targets highlighting with
accent-soft+ 2 px accent outline, pull-to-refresh with the envelope glyph (touch), haptics on iOS (selection for swipes crossing a threshold, success on send accepted, warning on failure).
6. Components (shared vocabulary)
| Component | Behaviour |
|---|---|
| Sidebar | Account switcher (avatar, address, unread), « Command Center », unified inbox, system folders, smart folders, labels (colour dot), user folders (tree), footer (storage meter, sync state, settings). Collapsible to an icon rail (web ≥ 1100 px, macOS). Translucent on macOS/iPadOS; opaque surface-2 on web unless backdrop-filter is supported and transparency is allowed. |
| Conversation row (card) | Avatar (initials on a hue derived from the address, or contact colour), sender (unread = 600), date (caption, tabular), subject, one- or two-line preview, right-aligned affordances: attachment clip, thread count pill, label dots, star, pin; left edge: unread dot. Hover (pointer) reveals quick actions (archive, delete, snooze, read) over the date. Selected = inset rounded accent-soft. |
| Reader | Subject + label chips, participants line with authentication badges, sticky contextual toolbar (reply, reply all, forward, archive, delete, move, label, snooze, remind, more), collapsed earlier messages as one-line cards, attachment strip with thumbnails, AI summary panel (only if enabled) clearly tinted info-soft and labelled with its provider. |
| Composer | Recipient token fields with autocomplete, identity and signature pickers, formatting bar (bold, italic, underline, strike, lists, quote, link, inline image, code, clear, snippet, template), attachment tray with previews, footer: send split button (send · send later · send + remind), undo countdown toast after sending, draft state (« Saved » / « Saving… » / « Offline — kept on this device »). |
| Command palette | ⌘K / Ctrl-K. Fuzzy search over commands, folders, mailboxes, labels, smart folders, contacts, recent searches; shows shortcuts; scoped prefixes > commands, @ contacts, # labels, / search. Level-2 glass, radius 14, max 640 px. |
| Toolbars | Contextual: selection toolbar replaces the list header when ≥ 1 row is selected; count + bulk actions. |
| Sync indicator | A single quiet element in the sidebar footer / toolbar: nothing when synced; « Offline · 3 pending » ; « Syncing » only if it lasts > 600 ms; error with retry. Never a blocking spinner. |
| Empty / loading / error | Skeleton rows matching the active density; empty states with one glyph, one line, one action; errors state what happened and offer retry. |
| Toasts | Bottom-left (web/macOS), top (iOS). One action maximum (Undo). Auto-dismiss 6 s, pause on hover/focus, role="status". |
| Attachment chip / tile | Type glyph or thumbnail, name (middle-truncated), size, quick look / download. Gallery uses tiles on a responsive grid. |
| Dashboard widget | Card level 1, header (title, optional action), body; resizable in 1×/2× widths on a 12-column grid (web), Grid on Apple; reorderable. |
7. Platform specifics
- Web — three columns ≥ 1100 px with draggable splitters (sidebar 200–360 px, list 300–560 px, persisted per device; double-click resets; keyboard-resizable via the separator role); two columns 760–1100 px with the sidebar as an overlay drawer; single column < 760 px with bottom navigation (Inbox, Search, Compose, Command Center, More) and swipe gestures on rows. Layout preference: reader right / reader below / no reader (list only).
- macOS —
NavigationSplitViewwith a translucent sidebar, unified customizable toolbar, inspector (contact profile / thread details) on the trailing edge, multiple windows (main, message, composer), menu bar extra, full menu commands with shortcuts, window state restoration. Controls and metrics follow macOS conventions (smaller targets, hover states, right-click menus). - iPadOS — three-column split view, keyboard shortcuts discoverable by holding ⌘, pointer hover effects, drag and drop between apps, Pencil: scribble in fields and mark-up of image/PDF attachments via Quick Look.
- iOS — bottom-reachable actions: floating compose button, bottom toolbar in the reader, full-swipe row actions (leading: read/unread, pin; trailing: archive, snooze, more), context menus with previews, sheets with detents for composer and filters, haptics.
8. Preferences added (synchronised in users.prefs unless marked device)
theme (system | light | dark | midnight — device), density (comfortable | cozy | compact), textSize, readingFont, layout (right | below | none — device), paneWidths (device), sidebarCollapsed (device), darkMessages, previewLines (0 | 1 | 2), avatars (bool), conversationView (bool), reduceTransparency (device, defaults to the OS setting), swipeLeading / swipeTrailing (touch), dashboard (widget layout).