Design System
The tokens and components behind this site.
Every sample on this page renders from css/redesign.css, the live stylesheet. If it looks wrong here, it looks wrong in production. The Brand Identity page covers the thinking.
Three colors, five tints.
Charcoal, ivory and cobalt are the only brand colors. Every other tone is charcoal or ivory at a lower opacity, defined once as a token.
--color-ink
#292929, charcoal
--color-paper
#F7F4ED, warm ivory
--color-accent
#315BDB, cobalt
| Token | Value | Contrast | Used for |
|---|---|---|---|
--ink-soft | Charcoal at 82% | 7.59:1 on ivory | Body copy |
--ink-muted | Charcoal at 72% | 5.55:1 on ivory | Labels and captions |
--rule | Charcoal at 20% | Not text | Hairlines between rows |
--rule-strong | Charcoal at 90% | Not text | Table tops, outlines, panels |
--paper-soft | Ivory at 78% | 8.63:1 on charcoal | Secondary text on dark bands |
Cobalt on ivory is 5.24:1, so cobalt is used for links and emphasis on ivory. Cobalt on charcoal is 2.53:1, so text on dark bands uses ivory.
One family, four weights.
Plus Jakarta Sans, loaded from assets/fonts/PlusJakartaSans.ttf with a system sans serif fallback. Four weights, each with one job.
| Token | Weight | Used for |
|---|---|---|
--w-head | 800 | Headings |
--w-sub | 700 | Subheadings, buttons, stat labels |
--w-label | 600 | Navigation and uppercase labels |
--w-body | 400 | Body copy |
| Style | Size | Notes |
|---|---|---|
| Body | 1.125rem, line height 1.6 | Prose is capped at 65 characters per line |
Hero title (.hero__title) | clamp(2.5rem, 1.2rem + 5.4vw, 4.5rem) | Weight 800, tight tracking, balanced wrapping |
Section title (.section__title) | clamp(1.75rem, 1.1rem + 2.4vw, 2.625rem) | Weight 800 |
Label (.label) | 0.8125rem | Weight 600, uppercase, wide tracking |
Label, accent
Label, muted
Subhead style
Body copy in 400 at 82% charcoal, held to a readable line length.
View markup
<p class="label label--accent">Label, accent</p> <p class="label label--muted">Label, muted</p> <p class="subhead">Subhead style</p> <div class="prose"><p>Body copy in 400 at 82% charcoal, held to a readable line length.</p></div>
A short scale, in rem.
Spacing is a short scale in rem, so it follows the reader's text size. Content sits in a shell capped at 75rem with a fluid gutter.
| Token | Value |
|---|---|
--s1 to --s7 | 0.5, 1, 1.5, 2, 3, 4 and 6 rem |
--shell | 75rem, the maximum content width |
--gutter | clamp(1.25rem, 0.4rem + 3.6vw, 4rem) |
--radius | 4px, used sparingly |
Layouts change at three widths, chosen by content: 40rem, 48rem and 64rem. Nothing relies on a fixed device size.
Two buttons.
Two button styles, plus the closing call to action. All keep a 44 px minimum height.
View markup
<div class="actions"> <a class="button" href="#buttons">Primary button</a> <a class="button button--outline" href="#buttons">Outline button</a> </div>
Static numbers.
The dark band shows a few verified results. Numbers are static text, so they display even when JavaScript is off. Approximate figures carry a tilde.
~1,500
Employees reached through AI training
10 days
Pre-Discovery sprint
A note under the numbers says what they are and are not.
View markup
<section class="results" aria-label="Results sample">
<div class="shell">
<div class="results__grid results__grid--two">
<div class="results__item"><p class="results__value">~1,500</p><p class="results__sub">Employees reached through AI training</p></div>
<div class="results__item"><p class="results__value">10 days</p><p class="results__sub">Pre-Discovery sprint</p></div>
</div>
<p class="results__note">A note under the numbers says what they are and are not.</p>
</div>
</section>Short processes, built natively.
Numbered steps for short processes, built in HTML and CSS. One step can be flagged.
- AuditRead what is already live
- DraftBuild the first real version
- What changedShipTest it with the people who push back
View markup
<ol class="pipeline"> <li class="pipeline__step"><strong>Audit</strong><span>Read what is already live</span></li> <li class="pipeline__step"><strong>Draft</strong><span>Build the first real version</span></li> <li class="pipeline__step pipeline__step--changed"><span class="pipeline__flag">What changed</span><strong>Ship</strong><span>Test it with the people who push back</span></li> </ol>
Decisions and facts.
Decisions use a title and a labeled reason. Facts use a term and a detail, and both stack on narrow screens.
A decision, stated plainly
WhyThe reason, in a sentence or two.
A decision with a cost
TradeoffWhat was given up, and why it was worth it.
View markup
<div class="decisions">
<div class="decision">
<h3 class="decision__title">A decision, stated plainly</h3>
<p class="decision__why"><span class="label label--muted">Why</span>The reason, in a sentence or two.</p>
</div>
<div class="decision">
<h3 class="decision__title">A decision with a cost</h3>
<p class="decision__why"><span class="label label--accent">Tradeoff</span>What was given up, and why it was worth it.</p>
</div>
</div>- Role
- Senior UX Designer
- Context
- A short line of context
View markup
<dl class="facts"> <div class="facts__row"><dt>Role</dt><dd>Senior UX Designer</dd></div> <div class="facts__row"><dt>Context</dt><dd>A short line of context</dd></div> </dl>
Tags, cards, comparisons and quotes.
Smaller pieces: tags for flat lists of nouns, project cards, a before and after comparison, and a pull quote.
View markup
<ul class="tags"> <li>Information Architecture</li> <li>Rapid Concept Prototyping</li> </ul>
Project name
One sentence on what it is.
Another project
One sentence on what it is.
View markup
<div class="projects"> <div class="project"><h3 class="project__name">Project name</h3><p class="project__desc">One sentence on what it is.</p></div> <div class="project"><h3 class="project__name">Another project</h3><p class="project__desc">One sentence on what it is.</p></div> </div>
The old way
- One short item
- Another short item
The new way
- One short item
- Another short item
View markup
<div class="compare">
<div class="compare__panel">
<span class="label label--muted">Before</span>
<p class="compare__title">The old way</p>
<ul class="compare__list compare__list--before"><li>One short item</li><li>Another short item</li></ul>
</div>
<div class="compare__panel compare__panel--after">
<span class="label label--accent">After</span>
<p class="compare__title">The new way</p>
<ul class="compare__list"><li>One short item</li><li>Another short item</li></ul>
</div>
</div>A line worth repeating.
View markup
<figure class="pullquote"><blockquote><p>A line worth repeating.</p></blockquote><figcaption>Attribution, when there is one</figcaption></figure>
Whole rows are the target.
Related work and next steps use full-width link rows with an arrow. The whole row is the target.
View markup
<ul class="related__list"> <li class="related__item"><a class="related__link" href="#lists"><span><span class="label label--accent">Deep dive</span>A link row with a short title</span><span class="related__arrow" aria-hidden="true">→</span></a></li> <li class="related__item"><a class="related__link" href="#lists"><span><span class="label label--accent">Next case study</span>Another link row</span><span class="related__arrow" aria-hidden="true">→</span></a></li> </ul>
Labeled as reconstructions.
Illustrations that stand in for project artifacts are labeled as conceptual reconstructions, with a caption that says what is example content. Dense images open in a native dialog with a scrollable full-size view, which takes focus, closes with Escape, and returns focus to the button that opened it.
Conceptual reconstruction
Illustrative example with synthetic content, recreated for this page.
View markup
<p><span class="artifact__tag">Conceptual reconstruction</span></p> <p class="figure-caption">Illustrative example with synthetic content, recreated for this page.</p>
Clear through underlines, outlines and weight.
Links are underlined as well as colored. Visited links turn charcoal. Hover thickens the underline, and keyboard focus draws a 3px cobalt outline offset by 3px, or an ivory outline on dark bands.
| State | Treatment |
|---|---|
| Link | Cobalt, underlined |
| Visited link | Charcoal, with a cobalt underline |
| Hover | Thicker underline. Buttons and the closing call to action turn cobalt. |
| Focus visible | 3px cobalt outline, 3px offset. Ivory on dark bands. |
| Current page | aria-current="page" with a charcoal underline |
| Reduced motion | Transitions and smooth scrolling are switched off |
What is built and measured.
This site is built to WCAG 2.2 AA. A scripted check of all 19 pages, at desktop width and at 320 px, found no failures, and keyboard tests cover the skip link, the menu and the image dialog. Screen reader testing was done with VoiceOver.
| Area | What is in place |
|---|---|
| Contrast | The text and background pairings are listed with their ratios on the Brand Identity page. The lowest used for text is 5.24:1. |
| Structure | A skip link, labeled landmarks, one h1 per page, and headings in order. |
| Keyboard | The skip link moves focus into the main content, and every control shows a 3px outline. The mobile menu reports aria-expanded and closes with Escape. The enlarged image dialog takes focus, keeps it inside, and returns it when it closes. |
| Targets | Navigation, footer links and buttons are at least 44 px tall. |
| Layout | Pages reflow to a single column with no sideways scroll at 320 px. |
| Checks run | Contrast, accessible names, headings, landmarks, tables, target size, focus indicators and ARIA references on every page. |
| Screen reader | Tested with VoiceOver. |
| Not yet done | A formal audit. |
Not built yet.
Not built yet: a form pattern. Contact is email only, on purpose, because the site has no server to handle form data safely.