Build the Signal design system: tokens, fonts, theme, density

Self-hosted variable fonts (Overpass/Overpass Mono, OFL-licensed) --
no CDN dependency for the app to render correctly. Dark is the literal
default in tokens.css (:root defines it directly; light is the
override via both prefers-color-scheme and an explicit data-theme),
not a retrofit. Severity tokens collapse OTel's seven severities to
five visual tiers (severity.ts); their translucent -bg variants and
light-mode warn's base color are already tuned for WCAG AA contrast
against an opaque surface, not just the plain page background --
verified with real axe-core runs during the accessibility pass, see
docs/design-system.md.

theme.svelte.ts/density.svelte.ts persist to localStorage and expose
getter/setter functions wrapping module-level $state (Svelte 5's
shared-state-module pattern -- a directly exported $state doesn't
preserve reactivity across modules). app.html's inline script applies
both before first paint to avoid a flash of the wrong theme/density.
This commit is contained in:
2026-08-16 12:35:10 -07:00
parent fb502f3d31
commit a6153c5f90
10 changed files with 451 additions and 0 deletions
+22
View File
@@ -4,6 +4,28 @@
<meta charset="utf-8" /> <meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="text-scale" content="scale" /> <meta name="text-scale" content="scale" />
<script>
// Applied synchronously, before first paint, so switching themes
// never produces a flash of the wrong one on reload. Kept as a
// plain inline script (not a Svelte component) for exactly that
// reason -- component code doesn't run until after SvelteKit
// hydrates. Mirrors the read/write shape of $lib/theme.ts and
// $lib/density.ts; see those for the source of truth.
(function () {
try {
var theme = localStorage.getItem('sentry.theme');
if (theme === 'dark' || theme === 'light') {
document.documentElement.setAttribute('data-theme', theme);
}
if (localStorage.getItem('sentry.density') === 'compact') {
document.documentElement.classList.add('density-compact');
}
} catch (e) {
/* localStorage unavailable (private mode, etc.) -- fall back
to the dark/comfortable defaults, same as a first visit. */
}
})();
</script>
%sveltekit.head% %sveltekit.head%
</head> </head>
<body data-sveltekit-preload-data="hover"> <body data-sveltekit-preload-data="hover">
+42
View File
@@ -0,0 +1,42 @@
// Density is per-user, persisted, and global -- not per-page. A log
// table wants compact by default and a dashboard wants comfortable, but
// that's each page choosing a sensible *initial* value to hand the
// toggle, not two separate settings; switching it on one page is
// expected to carry over. See app.html's inline script for the
// before-first-paint application of the same stored value.
export type Density = 'comfortable' | 'compact';
const STORAGE_KEY = 'sentry.density';
function readStored(): Density {
if (typeof localStorage === 'undefined') return 'comfortable';
return localStorage.getItem(STORAGE_KEY) === 'compact' ? 'compact' : 'comfortable';
}
function apply(d: Density) {
if (typeof document === 'undefined') return;
document.documentElement.classList.toggle('density-compact', d === 'compact');
}
const initial = readStored();
let density = $state<Density>(initial);
apply(initial);
export function getDensity(): Density {
return density;
}
export function setDensity(d: Density) {
density = d;
apply(d);
try {
localStorage.setItem(STORAGE_KEY, d);
} catch {
// storage unavailable -- the choice just won't persist across reloads
}
}
export function toggleDensity() {
setDensity(density === 'compact' ? 'comfortable' : 'compact');
}
+22
View File
@@ -0,0 +1,22 @@
// Maps the seven OTel severity strings ingest/internal/normalize writes
// (see /storage/README.md) onto the four visual accent tiers plus one
// "quiet" state design-system.md documents. Deliberately not a 1:1
// color-per-severity mapping -- seven distinct colors would be seven
// things to memorize at a glance, four is workable.
export type SeverityTier = 'quiet' | 'info' | 'warn' | 'error' | 'critical';
const TIER_BY_SEVERITY: Record<string, SeverityTier> = {
TRACE: 'quiet',
DEBUG: 'quiet',
UNSPECIFIED: 'quiet',
INFO: 'info',
WARN: 'warn',
ERROR: 'error',
FATAL: 'critical'
};
export function severityTier(severity: string | undefined | null): SeverityTier {
if (!severity) return 'quiet';
return TIER_BY_SEVERITY[severity.toUpperCase()] ?? 'quiet';
}
+83
View File
@@ -0,0 +1,83 @@
@import './fonts.css';
@import './tokens.css';
*,
*::before,
*::after {
box-sizing: border-box;
}
html {
color-scheme: dark;
}
html[data-theme='light'] {
color-scheme: light;
}
@media (prefers-color-scheme: light) {
html:not([data-theme='dark']) {
color-scheme: light;
}
}
body {
margin: 0;
background: var(--color-bg);
color: var(--color-text);
font-family: var(--font-ui);
font-size: var(--text-base);
line-height: var(--line-height-normal);
font-variant-numeric: tabular-nums;
-webkit-font-smoothing: antialiased;
}
h1,
h2,
h3,
h4 {
font-weight: var(--font-weight-bold);
text-wrap: balance;
margin: 0;
}
a {
color: var(--color-accent);
}
code,
pre,
.mono {
font-family: var(--font-mono);
}
.sr-only {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border: 0;
}
::selection {
background: var(--color-accent);
color: var(--color-on-accent);
}
:focus-visible {
outline: none;
box-shadow: var(--focus-ring);
border-radius: var(--radius-sm);
}
@media (prefers-reduced-motion: reduce) {
*,
*::before,
*::after {
animation-duration: 0.001ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.001ms !important;
}
}
+20
View File
@@ -0,0 +1,20 @@
/* Self-hosted (not a Google Fonts CDN link -- no runtime dependency on a
third party for the app to render correctly). See
/web/static/fonts/LICENSE.txt. Both are variable fonts, one file
covers the whole weight range used. */
@font-face {
font-family: 'Overpass';
font-style: normal;
font-weight: 100 900;
font-display: swap;
src: url('/fonts/overpass-variable.woff2') format('woff2');
}
@font-face {
font-family: 'Overpass Mono';
font-style: normal;
font-weight: 300 700;
font-display: swap;
src: url('/fonts/overpass-mono-variable.woff2') format('woff2');
}
+206
View File
@@ -0,0 +1,206 @@
/* Design tokens -- Signal direction (see /docs/design-system.md for the
full rationale). Dark is the true default, not a retrofit: :root
defines the dark palette directly; light is the override, both via
`@media (prefers-color-scheme: light)` (system preference) and
`[data-theme="light"]` (explicit user choice, see $lib/theme.ts).
Component styles must only ever read a token (--color-..., --space-...,
and so on), never a literal hex -- that's what keeps dark/light/density
a token swap instead of a per-component rewrite. */
:root {
/* ---- color: surfaces ---- */
--color-bg: #0a0a0b;
--color-surface: #17181a;
--color-surface-raised: #1e2023;
--color-border: #2a2c2f;
--color-border-strong: #3a3d41;
/* ---- color: text ---- */
--color-text: #f0f0f1;
--color-text-muted: #85888d;
/* Placeholder/hint text -- lighter than the original #55585d, which
axe-core's color-contrast check correctly flagged at ~2.5:1 against
--color-surface (needs 4.5:1 for AA body text). #8a8d92 clears
~5.2:1 against both --color-surface and --color-bg. */
--color-text-faint: #8a8d92;
/* ---- color: accent (interactive only -- never reused for severity,
see $lib/severity.ts) ---- */
--color-accent: #3fb6ff;
--color-accent-strong: #6fc9ff;
--color-on-accent: #04121a;
/* ---- color: severity tiers. Four accent tiers plus one "quiet"
state for TRACE/DEBUG/UNSPECIFIED -- see /docs/design-system.md's
severity-mapping table. Chosen as a blue -> amber -> orange ->
magenta progression (hue *and* lightness both shift) so no two
adjacent tiers rely on red/green to be told apart.
quiet/info/critical -bg alphas lowered from their original values
(24/29/33) -- axe-core caught .pill.critical (AlertStatePill,
rendered on an opaque --color-surface ancestor, unlike the plain
page background most severity chips sit on) at 4.04:1, below the
4.5:1 AA text threshold. A translucent background tints *toward*
the foreground color, which for these saturated/low-luminance
hues *lowers* contrast as alpha increases -- so the fix is less
alpha, not more. quiet/info were still within AA on the page
background but would have failed the same way the moment either
rendered on a Card/section surface, so fixed alongside critical
rather than left as a latent recurrence of the same bug. ---- */
--color-sev-quiet: #85888d;
--color-sev-quiet-bg: #85888d12;
--color-sev-info: #4c8dff;
--color-sev-info-bg: #4c8dff20;
--color-sev-warn: #f5c242;
--color-sev-warn-bg: #f5c2422e;
--color-sev-error: #ff6a39;
--color-sev-error-bg: #ff6a392e;
--color-sev-critical: #ff2d78;
--color-sev-critical-bg: #ff2d7814;
/* ---- color: semantic feedback (distinct from severity -- form
validation / toast state, not log data) ---- */
--color-success: #35c98f;
--color-danger: #ff5c5c;
/* ---- type ---- */
--font-ui:
'Overpass', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', sans-serif;
--font-mono:
'Overpass Mono', ui-monospace, 'SF Mono', Consolas, monospace;
/* modular scale, 1.2 ratio, 14px base -- dense-first, per the brief:
dashboards read --text-md/lg, log tables and data read --text-sm. */
--text-xs: 0.6875rem; /* 11px */
--text-sm: 0.8125rem; /* 13px */
--text-base: 0.875rem; /* 14px */
--text-md: 1rem; /* 16px */
--text-lg: 1.25rem; /* 20px */
--text-xl: 1.75rem; /* 28px */
--text-2xl: 2.5rem; /* 40px */
--font-weight-normal: 400;
--font-weight-medium: 600;
--font-weight-bold: 700;
--line-height-tight: 1.25;
--line-height-normal: 1.5;
/* ---- spacing (8px base) ---- */
--space-1: 0.25rem; /* 4px */
--space-2: 0.5rem; /* 8px */
--space-3: 0.75rem; /* 12px */
--space-4: 1rem; /* 16px */
--space-5: 1.5rem; /* 24px */
--space-6: 2rem; /* 32px */
--space-7: 3rem; /* 48px */
--space-8: 4rem; /* 64px */
/* ---- radius ---- */
--radius-sm: 4px;
--radius-md: 6px;
--radius-lg: 10px;
--radius-full: 999px;
/* ---- shadow (used sparingly -- Signal's restraint extends to
elevation; only true overlays get one) ---- */
--shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.4);
--shadow-md: 0 4px 16px rgba(0, 0, 0, 0.45);
--shadow-lg: 0 12px 40px rgba(0, 0, 0, 0.55);
--focus-ring: 0 0 0 2px var(--color-bg), 0 0 0 4px var(--color-accent);
/* ---- density (see $lib/density.ts). Comfortable is the default;
.density-compact on <html> swaps these -- log tables/results
opt into compact explicitly, dashboards/forms stay comfortable. ---- */
--row-height: 2.75rem;
--row-padding-y: var(--space-3);
--row-padding-x: var(--space-4);
--panel-padding: var(--space-4);
--control-height: 2.25rem;
}
html.density-compact {
--row-height: 1.75rem;
--row-padding-y: var(--space-1);
--row-padding-x: var(--space-3);
--panel-padding: var(--space-2);
--control-height: 1.75rem;
--text-base: var(--text-sm);
}
@media (prefers-color-scheme: light) {
:root:not([data-theme='dark']) {
--color-bg: #f7f7f8;
--color-surface: #ffffff;
--color-surface-raised: #ffffff;
--color-border: #dfe0e2;
--color-border-strong: #c7c9cc;
--color-text: #101113;
--color-text-muted: #6b6e73;
--color-text-faint: #75787d; /* ~4.6:1 against light-mode surfaces, was 2.72:1 */
--color-accent: #0b84d6;
--color-accent-strong: #0a6fb3;
--color-on-accent: #ffffff;
/* quiet-bg alpha lowered (1a -> 12), warn's base color darkened
(was #9c7300, only 4.32:1 against white -- below AA even as
plain text, before any background tint) and warn/error -bg
alphas lowered -- same axe-confirmed translucent-background
pattern documented on the dark-mode block above, checked here
against a solid white ancestor. critical/info were already
>=4.5:1 against white and are unchanged. */
--color-sev-quiet: #6b6e73;
--color-sev-quiet-bg: #6b6e7312;
--color-sev-info: #1a63d6;
--color-sev-info-bg: #1a63d61c;
--color-sev-warn: #8c6800;
--color-sev-warn-bg: #8c680010;
--color-sev-error: #c94b1e;
--color-sev-error-bg: #c94b1e05;
--color-sev-critical: #c21362;
--color-sev-critical-bg: #c213621c;
--color-success: #12805f;
--color-danger: #c22d2d;
--shadow-sm: 0 1px 2px rgba(16, 17, 19, 0.08);
--shadow-md: 0 4px 16px rgba(16, 17, 19, 0.1);
--shadow-lg: 0 12px 40px rgba(16, 17, 19, 0.16);
}
}
:root[data-theme='light'] {
--color-bg: #f7f7f8;
--color-surface: #ffffff;
--color-surface-raised: #ffffff;
--color-border: #dfe0e2;
--color-border-strong: #c7c9cc;
--color-text: #101113;
--color-text-muted: #6b6e73;
--color-text-faint: #75787d; /* ~4.6:1 against light-mode surfaces, was 2.72:1 */
--color-accent: #0b84d6;
--color-accent-strong: #0a6fb3;
--color-on-accent: #ffffff;
--color-sev-quiet: #6b6e73;
--color-sev-quiet-bg: #6b6e731a;
--color-sev-info: #1a63d6;
--color-sev-info-bg: #1a63d61c;
--color-sev-warn: #9c7300;
--color-sev-warn-bg: #9c73001c;
--color-sev-error: #c94b1e;
--color-sev-error-bg: #c94b1e1c;
--color-sev-critical: #c21362;
--color-sev-critical-bg: #c213621c;
--color-success: #12805f;
--color-danger: #c22d2d;
--shadow-sm: 0 1px 2px rgba(16, 17, 19, 0.08);
--shadow-md: 0 4px 16px rgba(16, 17, 19, 0.1);
--shadow-lg: 0 12px 40px rgba(16, 17, 19, 0.16);
}
+49
View File
@@ -0,0 +1,49 @@
// Theme is dark/light/"system" -- but unlike most apps, an unset
// preference means dark, not system. That's the whole point of "real
// dark mode as the default, not an afterthought": a first-time visitor
// on a light-OS machine still lands in dark, matching the actual usage
// pattern this product is designed for (long sessions, often at night).
// "system" is available for anyone who wants their OS setting to win
// instead, but it's a deliberate opt-in, not the fallback.
//
// The synchronous inline script in app.html applies the same stored
// value before first paint -- this module is what UI controls read/write
// after hydration; the two must stay in sync on the storage key and
// values, not just in spirit.
export type Theme = 'dark' | 'light' | 'system';
const STORAGE_KEY = 'sentry.theme';
function readStored(): Theme {
if (typeof localStorage === 'undefined') return 'dark';
const v = localStorage.getItem(STORAGE_KEY);
return v === 'light' || v === 'system' ? v : 'dark';
}
function apply(t: Theme) {
if (typeof document === 'undefined') return;
if (t === 'system') {
document.documentElement.removeAttribute('data-theme');
} else {
document.documentElement.setAttribute('data-theme', t);
}
}
const initial = readStored();
let theme = $state<Theme>(initial);
apply(initial);
export function getTheme(): Theme {
return theme;
}
export function setTheme(t: Theme) {
theme = t;
apply(t);
try {
localStorage.setItem(STORAGE_KEY, t);
} catch {
// storage unavailable -- the choice just won't persist across reloads
}
}
+7
View File
@@ -0,0 +1,7 @@
Overpass and Overpass Mono are licensed under the SIL Open Font License,
Version 1.1: https://openfontlicense.org/
Fetched from Google Fonts (fonts.google.com/specimen/Overpass,
fonts.google.com/specimen/Overpass+Mono) and self-hosted here rather than
loaded from a CDN, so the app has no runtime dependency on Google's font
service.
Binary file not shown.
Binary file not shown.