Design system
The primitives, tokens, text styles and components this site is built from, rendered live. Switch the theme at the top and everything below changes with it.
Jump to the components- Themes
- 3: Inspector, Riso, Memphis
- Tokens
- 45 semantic, defined by every theme
- Text styles
- 10 roles
- Components
- 37 WebC components
- Stack
- 11ty, WebC, CSS cascade layers. No JavaScript framework.
Overview
One markup tree and one token contract, printed three ways. The themes change how things look, never what they say or where they sit. The system has four layers, each built only from the one before it.
- Primitives Raw values, named for what they are: a theme's inks, the spacing and type scales.
- Tokens Named for a job, pointing at a primitive. Every theme defines every one.
- Text styles Ten roles built from type tokens. Every piece of text uses one.
- Components WebC components that use tokens and text styles only.
- One contract. Components use tokens only. The build fails if a theme misses one.
- Decor in its own layer. Signature details that tokens can't express (grain, halftones, stickers) live in each theme's decor file, in a later cascade layer, so they restyle components without specificity fights.
- Anything used twice is a component. Case study blocks written in markdown become the same WebC components as everything else.
- The docs read the code. Values on this page are parsed from the CSS, and "Used on" is found by scanning the templates, so neither can drift.
Brand
The logo is two lanes merging into one, read left to right: design and code arriving at one result. It is the same drawing everywhere, and each theme prints it on its own tile.
Logo
The mark on its own, and beside the name as it sits in the header. Shown in the active theme.
Construction
Drawn on a 34-unit square. The guides mark the two lanes, the line where they meet, where they start and the centre of the ring.
- Lanes. 3 units wide, 14 apart, starting 5.5 units in. They curve together and meet on the centre line.
- Ring. Radius 3.2 with a 2.6-unit stroke, centred 8.5 units from the right edge.
- Tile. The full square, its corners set by the theme: rounded in Inspector, square in Riso, a circle in Memphis.
In each theme
The drawing never changes; the tile follows the theme's primary colour and shape. All three are printed here, whichever theme is active.
Inspector A rounded ink tile.
Riso A square of speckled process blue with a pink offset.
Memphis A pink circle with a 3px ink outline.
Sizes and rules
| Where | Size | Source |
|---|---|---|
| Site header | 36px (2.25rem) | <brand-mark> |
| Link preview cards | 52px, 14px corners | <brand-mark> |
| Browser tab | 16 to 32px | src/favicon.svg, a static copy in Inspector colours |
- Beside the name. The mark always sits next to "Ioan Sameli", with at least a third of its size clear around it. The favicon is the only place it stands alone.
- 16px at the smallest. Below that the ring closes up.
- Drawn once. Never redraw, stretch or recolour it by hand. Colour and shape come from the theme's tokens and decor.
- Change both together. The component and the favicon are the same drawing; a change to one goes into the other.
Primitives
Raw values, named for what they are rather than what they're for. Only token and theme files use them; components never do.
Colour palette
Each theme's own inks. Shown for the active theme.
--inspector-paper
#f6f5f1
--inspector-dot
#d3cfc4
--inspector-white
#ffffff
--inspector-tab
#fbfaf7
--inspector-hairline
#e1ded6
--inspector-graphite
#5d5b55
--inspector-ink
#151514
--inspector-ink-raised
#1f1f1d
--inspector-ink-line
#3a3935
--inspector-ink-muted
#aaa79f
--inspector-ink-paper
#f3f2ee
--inspector-signal
#f2541b
--inspector-rust
#b83e0d
--inspector-yellow
#ffd21f
--inspector-ochre
#c99a00
--inspector-teal
#0c6e66
--inspector-teal-light
#74d7c8
--inspector-status
#12a594
--riso-paper
#e8e2d4
--riso-stock
#f5f0e4
--riso-navy
#1b3d8c
--riso-navy-muted
#3a5592
--riso-pink
#ff48b0
--riso-pink-tint
#f8b9d8
--riso-blue
#0a67a8
--riso-yellow
#ffe100
--memphis-cream
#fff7e8
--memphis-white
#ffffff
--memphis-ink
#141414
--memphis-muted
#3d3b38
--memphis-chalk
#e4e0d8
--memphis-pink
#ff5fa2
--memphis-yellow
#ffd23f
--memphis-teal
#1fc7c7
--memphis-purple
#7b5cff
Spacing scale
A 4px-based scale, shared by every theme.
--space-1
0.25rem · 4px
--space-2
0.5rem · 8px
--space-3
0.75rem · 12px
--space-4
1rem · 16px
--space-5
1.25rem · 20px
--space-6
1.5rem · 24px
--space-8
2rem · 32px
--space-10
2.5rem · 40px
--space-12
3rem · 48px
--space-16
4rem · 64px
--space-24
6rem · 96px
Type scale
Text sizes and line heights shared by every theme. Display sizes belong to each theme and are tokens.
| Primitive | Value | Used by |
|---|---|---|
--text-xs |
0.75rem |
Label |
--text-sm |
0.875rem |
Small and Meta |
--text-base |
1.0625rem |
Body |
--text-xl |
clamp(1.25rem, 1.15rem + 0.45vw, 1.5rem) |
Lead |
--leading-tight |
1.3 |
Labels and single-line UI |
--leading-snug |
1.45 |
Lead and small text |
--leading-normal |
1.6 |
Body text |
Tokens
Semantic tokens name a job (page background, focus ring, label weight) and point at a primitive. Every theme defines every one, so a component reads the same in all three. Values shown are for the active theme.
Colour
| Sample | Token | Value | Role |
|---|---|---|---|
--color-bg |
--inspector-paper#f6f5f1 --riso-paper#e8e2d4 --memphis-cream#fff7e8 |
Page background | |
--color-surface |
--inspector-white#ffffff --riso-stock#f5f0e4 --memphis-white#ffffff |
Panels, cards and controls | |
--color-surface-2 |
--inspector-tab#fbfaf7 --riso-stock#f5f0e4 --memphis-white#ffffff |
Panel header strips and tracks | |
--color-text |
--inspector-ink#151514 --riso-navy#1b3d8c --memphis-ink#141414 |
Reading text | |
--color-text-muted |
--inspector-graphite#5d5b55 --riso-navy-muted#3a5592 --memphis-muted#3d3b38 |
Secondary text, meta and labels | |
--color-border |
--inspector-hairline#e1ded6 --riso-navy#1b3d8c --memphis-ink#141414 |
Dividers and quiet outlines | |
--color-border-strong |
--inspector-ink#151514 --riso-navy#1b3d8c --memphis-ink#141414 |
Button outlines and hover rings | |
--color-signal |
--inspector-signal#f2541b --riso-pink#ff48b0 --memphis-pink#ff5fa2 |
Decorative accent: dots, pointers. Never text | |
--color-signal-ink |
--inspector-rust#b83e0d --riso-navy#1b3d8c --memphis-ink#141414 |
The accent when it must be read as text | |
--color-highlight |
--inspector-yellow#ffd21f --riso-pink-tint#f8b9d8 --memphis-white#ffffff |
Annotation labels, markers and selection | |
--color-on-highlight |
--inspector-ink#151514 --riso-navy#1b3d8c --memphis-ink#141414 |
Text on the highlight | |
--color-leader |
--inspector-ochre#c99a00 --riso-pink#ff48b0 --memphis-ink#141414 |
Annotation leader lines | |
--color-link |
--inspector-teal#0c6e66 --riso-navy#1b3d8c --memphis-ink#141414 |
Links | |
--color-success |
--inspector-status#12a594 --riso-pink#ff48b0 --memphis-teal#1fc7c7 |
Availability dot | |
--color-primary |
--inspector-ink#151514 --riso-blue#0a67a8 --memphis-pink#ff5fa2 |
Primary button, brand mark, active states | |
--color-on-primary |
--inspector-white#ffffff --riso-stock#f5f0e4 --memphis-ink#141414 |
Text on the primary colour | |
--color-focus |
--inspector-teal#0c6e66 --riso-pink#ff48b0 --memphis-purple#7b5cff |
Focus ring | |
--color-scrim |
color-mix(in srgb, var(--inspector-ink) 95%, transparent)color-mix(in srgb, var(--inspector-ink) 95%, transparent) color-mix(in srgb, var(--riso-navy) 96%, transparent)color-mix(in srgb, var(--riso-navy) 96%, transparent) color-mix(in srgb, var(--memphis-ink) 95%, transparent)color-mix(in srgb, var(--memphis-ink) 95%, transparent) |
Backdrop behind an enlarged image | |
--color-on-scrim |
--inspector-ink-paper#f3f2ee --riso-stock#f5f0e4 --memphis-white#ffffff |
Controls on the backdrop |
Type
| Token | Value | Role |
|---|---|---|
--font-display |
"Instrument Serif", "Iowan Old Style", Georgia, serif
"Archivo", "Arial Narrow", sans-serif
"Bungee", "Arial Black", sans-serif |
Headings and figures |
--font-body |
"Geist", system-ui, sans-serif
"Archivo", system-ui, sans-serif
"Rubik", system-ui, sans-serif |
Reading text |
--font-mono |
"Geist Mono", ui-monospace, "Cascadia Code", monospace
"Space Mono", ui-monospace, monospace
"Rubik", system-ui, sans-serif |
Meta |
--font-label |
var(--font-mono)
var(--font-mono)
"Rubik", system-ui, sans-serif |
Labels |
--font-code |
var(--font-mono)
var(--font-mono)
ui-monospace, "Cascadia Code", Menlo, monospace |
Code samples on /design-system/ |
--weight-display |
400
820
400 |
Display face weight |
--weight-strong |
600
700
700 |
Emphasis in the body face |
--weight-label |
500
700
800 |
Label weight |
--tracking-display |
-0.01em
-0.04em
0 |
Display letter spacing |
--leading-display |
0.95
0.92
1.02 |
Display line height |
--case-label |
none
uppercase
uppercase |
Label case |
--tracking-label |
0
0.12em
0.1em |
Label letter spacing |
--size-hero |
clamp(3.5rem, 2.1rem + 5.4vw, 6rem)
clamp(3rem, 1.7rem + 5vw, 5.5rem)
clamp(2.5rem, 1.5rem + 4vw, 4.5rem) |
Display |
--size-h2 |
clamp(2.5rem, 1.8rem + 2.8vw, 3.75rem)
clamp(2.25rem, 1.6rem + 2.6vw, 3.5rem)
clamp(1.875rem, 1.4rem + 1.9vw, 2.75rem) |
Headline |
--size-h3 |
clamp(1.75rem, 1.5rem + 1vw, 2.25rem)
clamp(1.5rem, 1.3rem + 0.8vw, 1.875rem)
clamp(1.25rem, 1.12rem + 0.5vw, 1.5rem) |
Title |
--size-h4 |
clamp(1.5rem, 1.35rem + 0.5vw, 1.875rem)
clamp(1.25rem, 1.12rem + 0.5vw, 1.5rem)
clamp(1.0625rem, 1rem + 0.3vw, 1.25rem) |
Subtitle |
--size-metric |
2.75rem
2.5rem
2rem |
Metric |
Shape and depth
Gentle and soft in Inspector, square with a printed offset in Riso, square panels and pill controls with hard neon shadows in Memphis.
--radius
Panels, cards and screenshots
--radius-control
Buttons and inputs
--radius-tag
Tags and labels
--radius-inset
Images set inside a panel
--border-width
Controls and dividers
--border-width-panel
Panels and cards
--shadow-panel
Panels and cards
--shadow-control
Buttons at rest
--shadow-control-hover
Buttons on hover
Motion
One duration and one easing. Motion is limited to small hover and press touches and the status pulse; backgrounds and decoration never move, and all of it switches off under reduced motion.
| Token | Value | Role |
|---|---|---|
--ease-out |
cubic-bezier(0.16, 1, 0.3, 1) |
Every transition |
--duration |
180ms |
Every transition |
--duration-reveal |
320ms |
Panels opening and closing |
Layout
A single centred container with a fluid gutter. Layout classes are prefixed l- and know nothing about the page they're on.
| Name | Value | Role |
|---|---|---|
--measure |
66ch |
Reading line length |
--container |
76rem |
Page width |
--gutter |
clamp(1rem, 4vw, 2.5rem) |
Page side padding |
--section-gap |
clamp(4.5rem, 3rem + 6vw, 8rem) |
Space between page sections |
.l-container | --container, --gutter | Centres content and pads its sides |
.l-section | --section-gap | Space above each top-level section |
.l-rail | 12rem rail from 56rem | A sticky contents rail beside a main column |
.l-flow | --flow-space, default 1em | Even space between stacked children |
| Breakpoints | 30rem · 48rem · 56rem · 62rem | Small phones · header stacks · two columns and rail · hero split |
Text styles
Ten roles cover every piece of text on the site. Each is one token, a font shorthand built from the theme's type tokens, with a matching .t-* class. Components never set a raw font size.
Families
At most three self-hosted families per theme, and only the active theme's fonts download.
--font-display
Headings and figures
"Instrument Serif", "Iowan Old Style", Georgia, serif
"Archivo", "Arial Narrow", sans-serif
"Bungee", "Arial Black", sans-serif
--font-body
Reading text
"Geist", system-ui, sans-serif
"Archivo", system-ui, sans-serif
"Rubik", system-ui, sans-serif
--font-mono
Meta
"Geist Mono", ui-monospace, "Cascadia Code", monospace
"Space Mono", ui-monospace, monospace
"Rubik", system-ui, sans-serif
--font-label
Labels
var(--font-mono)
var(--font-mono)
"Rubik", system-ui, sans-serif
--font-code
Code samples on /design-system/
var(--font-mono)
var(--font-mono)
ui-monospace, "Cascadia Code", Menlo, monospace
The ten roles
A clear headline for the page.
- Style
- Display
- Token
--type-display.t-display- Used for
- Home hero and 404 titles
- Now
- Size and leading at this window width, shown with JavaScript.
Section heading
- Style
- Headline
- Token
--type-headline.t-headline- Used for
- Section titles and page titles
- Now
- Size and leading at this window width, shown with JavaScript.
Project title
- Style
- Title
- Token
--type-title.t-title- Used for
- Card titles, case study sections, contact lead
- Now
- Size and leading at this window width, shown with JavaScript.
A subsection
- Style
- Subtitle
- Token
--type-subtitle.t-subtitle- Used for
- Case study subheadings and pull quotes
- Now
- Size and leading at this window width, shown with JavaScript.
1,234
- Style
- Metric
- Token
--type-metric.t-metric- Used for
- Figures in the highlights list
- Now
- Size and leading at this window width, shown with JavaScript.
One or two sentences that introduce the page and say what it covers.
- Style
- Lead
- Token
--type-lead.t-lead- Used for
- The line under a page title
- Now
- Size and leading at this window width, shown with JavaScript.
Body text for paragraphs and lists. It sets the reading rhythm for anything longer than a line or two.
- Style
- Body
- Token
--type-body.t-body- Used for
- Reading text
- Now
- Size and leading at this window width, shown with JavaScript.
A caption under a figure, saying what the reader should notice.
- Style
- Small
- Token
--type-small.t-small- Used for
- Captions, nav, contents, fact values
- Now
- Size and leading at this window width, shown with JavaScript.
- Style
- Meta
- Token
--type-meta.t-meta- Used for
- Company, dates, place, sources, footer
- Now
- Size and leading at this window width, shown with JavaScript.
Label
- Style
- Label
- Token
--type-label.t-label- Used for
- Panel labels, tags, annotations, keys
- Now
- Size and leading at this window width, shown with JavaScript.
Components
Every component on the site, grouped by job, each with a live example in the active theme. Page-level ones, like the header, render as a second copy here.
Site chrome
Site header
<site-header>
The brand, the main navigation and the theme switcher, at the top of every page.
Example
- When to use
- Once per page, from the base layout. Never place it inside page content.
- Variants
- Narrow Below 48rem the switcher moves to its own full-width row, and below 30rem the navigation does too.
- Accessibility
- A <header> landmark with a <nav aria-label="Main">.
- The link to the current page carries aria-current="page".
- The pinned note is decorative and is hidden on narrow screens.
- Used on
Show usage and propsHide usage and props
<site-header :@site="site" :@themes="themes" :@nav="nav" :@current="page.url"></site-header>| Prop | Type | Default | Description |
|---|---|---|---|
site | { name } | required | Site name for the brand link. |
themes | [{ id, label }] | required | Passed to the theme switcher. |
nav | [{ label, href }] | required | Main navigation, from src/_data/nav.json. |
current | string | required | The page URL, to mark its own link as current. |
Brand mark
<brand-mark>
The logo: two lanes merging into one, reversed out of a tile in the primary colour. Design and code, arriving at one result.
Example
- When to use
- Beside the name: in the site header and on the link preview cards.
- The favicon is a static copy of the same drawing, in Inspector colours (src/favicon.svg). Change both together.
- Variants
- Inspector A rounded ink tile.
- Riso A square of speckled process blue with a pink offset.
- Memphis A pink circle with a 3px ink outline.
- Accessibility
- Decorative and hidden from assistive technology: the name beside it carries the meaning.
- The lanes are on-primary on primary, a pair checked against AA in every theme at build time.
- Used on
Show usage and propsHide usage and props
<a href="/"><brand-mark></brand-mark>Ioan Sameli</a>No props.
Theme switcher
<theme-switcher>
A segmented control that swaps the site between its three themes. The choice is saved and applied before first paint on the next visit.
Example
- When to use
- In the site header. A second copy, like the one below, stays in sync with it.
- Variants
- Pressed The active theme: a raised tab in Inspector, solid ink in Riso, a pink pill in Memphis.
- Accessibility
- A group of real buttons labelled "Theme", each with aria-pressed.
- Rendered hidden and revealed by JavaScript, so it never shows when it can't work.
- A ?theme=<id> URL parameter links to a specific theme.
- Used on
Show usage and propsHide usage and props
<theme-switcher :@themes="themes"></theme-switcher>| Prop | Type | Default | Description |
|---|---|---|---|
themes | [{ id, label }] | required | From src/_data/themes.json. |
Site footer
<site-footer>
Copyright and a line on how the site is built, at the foot of every page.
Example
- When to use
- Once per page, from the base layout.
- Accessibility
- A <footer> landmark.
- Used on
Show usage and propsHide usage and props
<site-footer :@site="site"></site-footer>| Prop | Type | Default | Description |
|---|---|---|---|
site | { name } | required | Site name for the copyright line. |
Page decor
<page-decor>
Five empty shapes behind the page that each theme may draw or hide: none in Inspector, halftone plates in Riso, geometric shapes in Memphis.
Example
Inspector draws no decoration. Switch to Riso or Memphis to see the shapes.
- When to use
- Once, from the base layout. Decoration never goes anywhere else.
- Accessibility
- Hidden from assistive technology. It never animates, and below 48rem it moves clear of text.
- Used on
Show usage and propsHide usage and props
<page-decor></page-decor>No props.
Page layout
Page intro
<page-intro>
A page's title block: an optional back link, the h1, a lead line, then meta or actions.
Example
Hero
A clear headline for the page.
One or two sentences that introduce the page and say what it covers.
Page
- When to use
- Once per page, at the top of the main content.
- Variants
- Hero The title in Display, held to 12ch. Home and 404.
- Page The title in Headline, held to 18ch, for longer titles. Case studies and this page.
- Accessibility
- Nothing sits above the h1 except navigation: no kicker, eyebrow or meta line.
- Used on
Show usage and propsHide usage and props
<page-intro @title="Page title" @lead="One line that says what the page is.">
<arrow-link slot="before" @variant="back" href="/">Home</arrow-link>
<link-button @href="#start" @variant="primary">Start here</link-button>
</page-intro>| Prop | Type | Default | Description |
|---|---|---|---|
title | string | required | The page's h1. |
lead | string | none | The line under the title. |
size | "hero" | "page" | "page" | Which heading role the title takes. |
anchor | string | none | An id for the h1, to label the surrounding section. |
Page section
<page-section>
A top-level section of a page: the container, the section gap above it and a Headline title.
Example
Section title
Section content: paragraphs, lists or any other component.
- When to use
- For every top-level section, so titles, spacing and anchors stay consistent.
- Variants
- Memphis The title sits on a tilted black slab.
- Accessibility
- A <section> labelled by its own h2, so it shows up as a region.
- Used on
Show usage and propsHide usage and props
<page-section id="about" @title="About">
<p>Section content.</p>
</page-section>| Prop | Type | Default | Description |
|---|---|---|---|
id | string | required | The section's anchor. The title gets <id>-title. |
title | string | required | The section's h2. |
Page divider
<page-divider>
A full-width rule between two parts of a page: a hairline in Inspector, a navy rule with its pink plate printed off register in Riso, a 3px ink rule in Memphis.
Example
Above the rule
Below the rule
- When to use
- Between a page's own controls or preface and its content, such as the CV's introduction and Download PDF above the CV itself. Not between sections: they are spaced, not ruled.
- Accessibility
- An <hr>, a thematic break: assistive technology announces it as a separator.
- Used on
Show usage and propsHide usage and props
<page-divider></page-divider>No props.
Page contents
<page-contents>
The list of sections on a long page. From 56rem it is a sticky rail beside the content, with the section in view marked; on phones it is a collapsed control.
Example
Contents
- When to use
- On long, sectioned pages: case studies and this page. Pair it with the l-rail layout.
- Variants
- Rail From 56rem: always open and sticky.
- Collapsed Below 56rem: a bordered disclosure, closed by default.
- Nested Entries with sub-entries, as on this page.
- Accessibility
- A <details> element, so it works without JavaScript.
- It sits below the site header while the header is pinned, so the two never overlap.
- The section in view gets aria-current="true", not just a colour change.
- Used on
Show usage and propsHide usage and props
<div class="l-container l-rail">
<page-contents :@items="toc"></page-contents>
<div>…sections…</div>
</div>| Prop | Type | Default | Description |
|---|---|---|---|
items | [{ id, title, items? }] | required | One entry per section heading, with one optional level of nested entries. |
open | boolean | false | Render it open, as in the example here. |
Case pager
<case-pager>
Previous and next links at the end of a case study, in the case study order.
Example
- When to use
- At the foot of each case study.
- Variants
- Previous only, next only The first and last case studies show one link.
- Accessibility
- A <nav> labelled "More case studies". The direction is written out, not shown only by the arrow.
- Used on
Show usage and propsHide usage and props
<case-pager :@prev="study.prev" :@next="study.next"></case-pager>| Prop | Type | Default | Description |
|---|---|---|---|
prev | { url, title } | null | required | The previous case study. |
next | { url, title } | null | required | The next case study. |
Panels and lists
Info panel
<info-panel>
A framed container with a label strip: a file tab in Inspector, an ink bar in Riso, a hazard stripe in Memphis.
Example
- Companies
- What the company does, in one sentence.Role · City · 2020–2024 What the company does, in one sentence.Role · City · 2016–2020
- Locations
- City one: 5 years City two: 3 years
- Tools
- When to use
- For a self-contained group of facts beside the main text: highlights, skills, contact, a case study at a glance.
- Variants
- Default Surface, border and the theme's panel shadow.
- With status A live status chip at the end of the label strip, such as availability.
- Heavy The page's one dense block. Inspector and Memphis invert it by redefining the colour tokens on it, so the content inside needs no changes. One per page at most.
- Accessibility
- The label is plain text, not a heading. Add a heading inside when the panel needs a place in the outline.
- The status is plain text after a decorative dot, so it reads the same without the colour.
- Used on
Show usage and propsHide usage and props
<info-panel @label="Highlights" @variant="heavy">
<metric-list :@items="highlights"></metric-list>
</info-panel>| Prop | Type | Default | Description |
|---|---|---|---|
label | string | required | The text in the label strip. |
variant | "heavy" | none | The inverted, page-anchoring panel. |
status | string | none | A live status at the end of the label strip, after a pulsing status dot, on a chip (home: Available now). |
At a glance panel
<glance-panel>
The heavy panel about Ioan: a status chip, the portrait beside his name and target title, years of experience as two figures, then a fact list. It opens the home page and the CV.
Example
Person name
Job title · field
- 10+ years
- in the first field
- 15+ years
- in the second field
- Based in
- City, Country
- Languages
- Language one, Language two
- Tools
- When to use
- Beside the opening of a page about Ioan himself, never about a project (a case study's facts panel is a plain info panel). Its content lives in src/_data/glance.js, so both pages always agree.
- Variants
- With links Ends with Read the CV and Download PDF.
- With rows Extra fact rows after Based in, such as the CV's contact details.
- Portrait Round in Inspector, a two-ink duotone over a halftone plate in Riso, square in Memphis.
- Accessibility
- The years are a description list: each figure is read with its label.
- Company names open tooltips by hover, focus or tap (the page sets hasTooltips: true).
- Used on
Show usage and propsHide usage and props
<glance-panel :@glance="glance"></glance-panel>| Prop | Type | Default | Description |
|---|---|---|---|
glance | { status, photo, photoAlt, name, title, years, facts } | required | From src/_data/glance.js. |
links | boolean | false | Show Read the CV and Download PDF. |
pdf | string | none | The PDF's URL, with links. |
rows | [{ label, value, href? }] | none | Rows added after Based in. The CV adds its contact details: email, phone (PDF only), website and LinkedIn. |
Work cards
<work-cards>
The case study cards on the home page, in an even grid: the case study's 2:1 hero edge to edge across the top, then up to three tags, title, summary, one key figure and a call to read on.
Example
-
Project title
One or two sentences on the problem and what changed.
+5% the result, in a short phrase
-
- When to use
- To list case studies. Every case study uses the same card at the same size.
- Variants
- With note A card may carry a short annotation pinned to its top edge, a fact from that case study.
- Hero The case study's 2:1 hero (frontmatter hero:) bleeds to the card's edges across its top, above a rule.
- Hero to come Without a hero, a muted 2:1 band reading Hero image to come, on the dev server only; production builds leave it out.
- Accessibility
- An ordered list of articles. The title link stretches over the whole card, and the focus ring is drawn on the card.
- "Read the case study" is hidden from assistive technology, since the title link already says where it goes.
- The hero is decorative (empty alt), since the title link already names the card.
- Used on
Show usage and propsHide usage and props
<work-cards :@items="work"></work-cards>| Prop | Type | Default | Description |
|---|---|---|---|
items | [{ url, title, summary, company, timeline, tags, figure?, note?, hero?, slot? }] | required | From src/_data/work.js. hero: the image path; slot: show the placeholder instead. |
Fact list
<fact-list>
Label and value rows, divided by dashed rules. Values can be links.
Example
Default
- Company
- Company name
- Role
- Lead designer
- Timeline
- 2024
Large
- name@example.com
- Website
- example.com
- When to use
- For short reference facts (company, role, timeline) or contact details. A row can hold tags (a short list such as tools), separate lines, or terms that each open a tooltip.
- Variants
- Default Small values, tight rows, for reference.
- Large Body-size values and roomier rows, for when the values are the point. Stacks below 30rem.
- Accessibility
- A description list, so each label is announced with its value.
- Used on
Show usage and propsHide usage and props
<fact-list :@items="[{ label: 'Role', value: 'Lead designer' }]"></fact-list>| Prop | Type | Default | Description |
|---|---|---|---|
items | [{ label, value?, href?, tags?, lines?, terms? }] | required | Rows. href: the value is a link. tags: a tag list. lines: one line each. terms: [{ text, tip, meta? }], a comma-separated list of tooltips (the page sets hasTooltips: true). |
size | "large" | none | Roomier rows and body-size values. |
Metric list
<metric-list>
Key figures: a display-face value, what it counts, and where it comes from. Values are exact, never rounded up.
Example
Default
Compact
- When to use
- For a page's key results, inside a panel. Every figure links to, or names, its source.
- Variants
- Default A wide value column.
- Compact The value above its label, for side panels, so a long figure never squeezes the label.
- Accessibility
- A description list. Figures use tabular numerals so columns line up.
- Used on
Show usage and propsHide usage and props
<metric-list :@items="highlights" @density="compact"></metric-list>| Prop | Type | Default | Description |
|---|---|---|---|
items | [{ value, label, source?, url? }] | required | One row per figure. |
density | "compact" | none | Value above label. |
Tag list
<tag-list>
Short topic labels in a wrapping row.
Example
- When to use
- For topics and skills. Tags are labels, not links or filters.
- Accessibility
- A list labelled "Topics" by default; pass a label when the tags are something else, such as tools.
- Used on
Show usage and propsHide usage and props
<tag-list :@tags="['Design systems', 'Front-end']"></tag-list>| Prop | Type | Default | Description |
|---|---|---|---|
tags | [string] | required | The labels. |
label | string | "Topics" | The list's accessible name. |
Annotations and status
Pinned note
<pinned-note>
A short label pinned to something with a leader line: a yellow mono tag in Inspector, a tilted highlighter band in Riso, a sticker in Memphis.
Example
- When to use
- To point out one fact about the thing beside it. The parent places it; on narrow screens it moves into the flow or is dropped.
- For an annotation that appears on hover, use the Term tooltip, which draws this pinned note over a word.
- Variants
- Up, down, left, right The direction of the leader line.
- None No leader. Used for figure legends, with a leading number that matches a marker.
- Accessibility
- Plain text in the reading order. Never the only place a piece of information appears (a hover annotation, the Term tooltip, holds extra detail only).
- Used on
Show usage and propsHide usage and props
<pinned-note @side="up">Exact figures, never rounded up</pinned-note>| Prop | Type | Default | Description |
|---|---|---|---|
side | "up" | "down" | "left" | "right" | "none" | "down" | Where the leader points. |
label | string | slot | The text, when it comes from data. |
number | string | none | A leading numeral for legends. |
Term tooltip
<term-tooltip>
An annotation that appears on hover: a word with a dotted underline that opens a pinned note above it, leader pointing down at the word, in that theme's pinned-note look. A sentence or two, then an optional meta line.
Example
A sentence with a A short explanation of the term, in one sentence.Extra detail · on a second line that explains itself on hover.
- When to use
- For a short aside about a term that doesn't need its own page, such as what a company does and Ioan's role, place and dates there. Unlike a Pinned note, its text wraps, so a sentence or two fits.
- Never for anything a reader must see: it stays hidden until asked for.
- Variants
- With meta A second line, such as role · place · dates.
- Accessibility
- The trigger is a real button, so it takes keyboard focus; the bubble has role="tooltip" and is linked with aria-describedby.
- Opens on hover and on keyboard focus; tap toggles it on touch screens. Escape or a tap elsewhere closes it.
- The page sets hasTooltips: true to load assets/js/tooltip.js, which also keeps the bubble inside the viewport.
- Used on
Show usage and propsHide usage and props
<term-tooltip @label="term" @tip="A short explanation of the term, in one sentence." @meta="Extra detail · on a second line"></term-tooltip>| Prop | Type | Default | Description |
|---|---|---|---|
label | string | required | The trigger text. |
tip | string | required | The annotation's first line. |
meta | string | none | A second line. |
Status dot
<status-dot>
A small dot for live status, such as availability, with a ring that pulses outward every 2 seconds.
Example
- When to use
- Before a line that states the status in words.
- Accessibility
- Decorative and hidden: the text beside it carries the meaning.
- The pulse stops under reduced motion.
- Used on
Show usage and propsHide usage and props
<p><status-dot></status-dot>Open to new roles</p>No props.
Inline metric
<inline-metric>
A key figure inside running text: the value in the display face at 1.5 times the text size, then its label.
Example
42 items counted, in a short phrase
- When to use
- When one figure supports a sentence or a card. Never as a big-number card.
- Accessibility
- Value and label read as one phrase.
- Used on
Show usage and propsHide usage and props
<p><inline-metric @value="42" @label="items counted, in a short phrase"></inline-metric></p>| Prop | Type | Default | Description |
|---|---|---|---|
value | string | required | The exact figure. |
label | string | required | What it counts. |
Actions
Link button
<link-button>
A link styled as a button, for the main calls to action. Hover and press touches are part of each theme.
Example
- When to use
- For one or two key actions in a page intro or at the end of a flow. Use a text link everywhere else.
- Variants
- Primary Primary fill, with a trailing arrow. One per group.
- Secondary Surface fill with a strong border.
- Accessibility
- A real link, since every action goes somewhere. At least 48px tall.
- Focus shows a 2px ring in the theme's focus colour, 3px off the edge.
- Used on
Show usage and propsHide usage and props
<link-button @href="#work" @variant="primary" @icon="arrow-right">See the work</link-button>| Prop | Type | Default | Description |
|---|---|---|---|
href | string | required | Where it goes. |
variant | "primary" | "secondary" | "secondary" | Visual weight. |
icon | line-icon name | none | A trailing icon. |
target | "_blank" | none | Opens the link in a new tab. |
Arrow link
<arrow-link>
A text link with an arrow: a strong link with the icon after it, or a quiet back link with the icon in front.
- When to use
- For secondary navigation: going up a level, or out to a live product.
- Variants
- Default Strong text, icon after.
- Back Label style, muted, arrow in front. Sits above a page title as navigation.
- Accessibility
- The icon is decorative; the text says where the link goes.
- Used on
Show usage and propsHide usage and props
<arrow-link @variant="back" href="/#work">All work</arrow-link>
<arrow-link href="https://example.com" @icon="arrow-up-right">See it live</arrow-link>| Prop | Type | Default | Description |
|---|---|---|---|
href | string | required | Where it goes. |
icon | line-icon name | none (back: arrow-left) | The arrow. |
variant | "back" | none | Quiet, label-style back link. |
Line icon
<line-icon>
A small stroked icon that takes the text colour and size: arrows, download, plus expand and close for the image zoom.
Example
- When to use
- Inside buttons and links, to show direction or an action. Never on its own.
- Variants
- arrow-right Forward, onward.
- arrow-left Back.
- arrow-up-right Leaves the site.
- download Downloads a file, such as the CV PDF.
- expand Opens a larger view.
- close Closes an overlay.
- Accessibility
- Hidden from assistive technology and never focusable.
- Used on
Show usage and propsHide usage and props
<line-icon @name="arrow-right"></line-icon>| Prop | Type | Default | Description |
|---|---|---|---|
name | "arrow-right" | "arrow-left" | "arrow-up-right" | "download" | "expand" | "close" | required | Which icon. |
Case study blocks
Case studies are written in markdown. These blocks are what a few markdown conventions become at build time, so the writing stays plain text and the page uses the same components as everything else.
Side quest
<side-quest>
A short story or detail beside the main one, in a collapsible panel, closed by default. The header strip holds the title, a one-sentence overview under it and the "Side quest" tag, so a reader knows what they'd get before opening it.
Example
An optional detour
One sentence on what's inside.Side quest
The detail a reader may skip, one click away.
- When to use
- For a short story or supporting detail a reader may skip. Keep the main story readable without it.
- Write the overview as one sentence that tells the reader what's inside, not a repeat of the first line of the body.
- Variants
- Open, closed The chevron points down when closed and up when open. The body slides open and fades in, and folds shut on close (--duration-reveal, 320ms).
- Accessibility
- A <details> element: keyboard and screen reader support come for free, and it works without JavaScript.
- The open and close animation is CSS only and off under reduced motion; browsers without ::details-content snap open with just the fade.
- The title is a real heading, one level below its context. The tag, title and overview together are the toggle's accessible name.
- Used on
Show usage and propsHide usage and props
::: side-quest Title in markdown
overview: One sentence on what's inside.
Body
:::
<side-quest @title="Why we chose this" @overview="One sentence on what's inside." @id="why" @level="4">
<p>The detail.</p>
</side-quest>| Prop | Type | Default | Description |
|---|---|---|---|
title | HTML string | required | What the side quest is about. |
overview | HTML string | none | One sentence under the title, in the header strip. Required in case studies. |
id | string | required | The heading's anchor. |
level | "3" | "4" | "5" | "3" | The heading level, one below its context. |
Figure tag
<figure-tag>
The short label on a figure or diagram row, such as Before or After: a file tab in Inspector, a speckled ink chip in Riso, a tilted black label in Memphis.
Example
- When to use
- To name the sides of a comparison in an Image figure or Flow diagram.
- For topic labels on a card, use Tag list instead.
- Accessibility
- Plain text, read in place. Keep it to a word or two.
- Used on
Show usage and propsHide usage and props
<figure-tag @label="Before"></figure-tag>| Prop | Type | Default | Description |
|---|---|---|---|
label | string | required | The label. |
Figure marker
<figure-marker>
The numbered dot that ties a spot in a figure or diagram to its legend entry: yellow with a white ring in Inspector, pink tint with navy numerals in Riso, yellow with an ink outline and offset in Memphis.
Example
- When to use
- To point at something without covering it. The words go in a numbered legend, never on the figure.
- Accessibility
- On the figure it is hidden from assistive technology, because the numbered legend carries the same information.
- Used on
Show usage and propsHide usage and props
<figure-marker :@number="1"></figure-marker>| Prop | Type | Default | Description |
|---|---|---|---|
number | number | required | Matches an entry in the legend. |
Image figure
<image-figure>
Screenshots in the theme's frame, with an optional before/after tag, numbered markers and a caption with a matching legend.
Example
- 1What the marker points at
What the reader should notice in the figure.
Three images
Illustration
A simple drawing in the theme's colours.
- When to use
- For evidence: real screenshots of shipped work. Never pass redrawn UI off as a screenshot.
- Variants
- Single Uses the full prose column.
- Pair Two images side by side, stacking below 40rem. Usually before and after.
- Three images Three images side by side, stacking below 40rem. For a set of small related examples.
- Portrait Phone screenshots, centred, at most 20rem wide.
- Illustration A one-off coded drawing in the theme's panel, inlined so it follows the theme. If it redraws UI, the caption says it is a reconstruction.
- Placeholder A dashed "Visual to come" box, on the dev server only.
- Accessibility
- Every image has alt text that describes what it shows.
- Markers are hidden from assistive technology; the numbered legend in the caption carries the same labels.
- Labels never cover the evidence: the marker sits beside it, the words go in the legend.
- Used on
Show usage and propsHide usage and props
::: figure
image: /assets/img/work/shot.webp | 1600x1000 | Alt text | Before
large: /assets/img/work/shot-large.webp
note: 1 | 40% 30% | What the marker points at
caption: What the reader should notice.
:::
::: figure
illustration: drawing.svg | Alt text
caption: Reconstruction of what it shows.
:::| Prop | Type | Default | Description |
|---|---|---|---|
images | [{ src, width, height, alt, label?, large?, markers? }] | required | One, two or three images. large: a bigger file for the enlarged view. markers: [{ n, x, y }] in percent. |
notes | [{ n, label }] | none | The legend. |
caption | HTML string | none | The caption. |
illustration | SVG string | none | A one-off drawing, instead of images. From markdown, a file in content/illustrations; alt text is required. |
placeholder | string | none | A visual still to come. |
Image zoom
<image-zoom>
A screenshot that opens full screen on click: a dark backdrop, the image as large as the screen allows, and a round close button. An expand badge shows on hover and focus, and always on touch screens.
Example
- When to use
- For screenshots worth a closer look. Every Image figure screenshot uses it; small crops that are readable in place don't need it.
- Accessibility
- A link to the image file, so it works without JavaScript; the script turns it into a modal dialog.
- The link says "Enlarge image" to screen readers, after the image's alt text.
- Escape, the close button or a click anywhere closes it, and focus returns to the link.
- The grow and shrink animation is skipped under reduced motion.
- Used on
Show usage and propsHide usage and props
<image-zoom @src="/assets/img/work/shot.webp" @width="1500" @height="750" @alt="What it shows"></image-zoom>| Prop | Type | Default | Description |
|---|---|---|---|
src, width, height, alt | string | required | The image, as for an img. |
large | string | src | A bigger file for the enlarged view. |
Feature cards
<feature-cards>
A set of features in the theme's panels, each with a small screenshot, a title and a short description.
Example
- When to use
- For a list of features where seeing each one says more than naming it.
- For one large screenshot with annotations, use Image figure instead.
- Variants
- Two columns Cards sit in two columns and stack below 40rem.
- Odd last card With an odd number of cards, the last one spans both columns, screenshot on the left, text lined up with the second column.
- With a button A card given a link shows a Try it button, pinned to its bottom so the buttons in a row line up. Cards without a link simply have none.
- Accessibility
- Exposed as a list, so its length is announced.
- Every screenshot has alt text that describes what it shows.
- Each Try it button includes its card's title for screen readers, so the links are distinct.
- Used on
Show usage and propsHide usage and props
::: cards
card: /assets/img/work/shot.webp | 1000x500 | Alt text | Title | What it does. | /path/to/live/component
:::| Prop | Type | Default | Description |
|---|---|---|---|
cards | [{ src, width, height, alt, title, text, link? }] | required | The cards. text is an HTML string; from markdown it may use inline formatting. link adds a Try it button that opens in a new tab. |
Step flows
<step-flows>
Step-by-step flows side by side in the theme's panel: each flow a column under its tag, with screenshots of each state and, between them, an arrow with what happens next. Steps at the same position line up across the flows.
Example
-
- Tap the button Another screen opens.
-
Another screen
- Complete it The visitor returns to the page, in the new state.
-
-
- Tap the button The button shows a loading state.
-
- Request processed The component returns to its first state, and a message confirms.
-
What the reader should notice across the flows.
- When to use
- To show how a component behaves: its states and what moves it from one to the next, for one or more paths through it.
- Crop each state to the part that changes. For a single screenshot, or a before and after, use Image figure.
- Variants
- Side by side One column per flow, stacking when the figure is narrower than 40rem.
- Stand-in A dashed box naming a state that isn't shown, such as a screen outside the component.
- Accessibility
- Each flow is an ordered list named after its tag, so its steps and their count are announced in order.
- Every screenshot has alt text that describes the state it shows.
- The arrows are drawn in CSS; the action and its result carry the meaning in text.
- Used on
Show usage and propsHide usage and props
::: steps
flow: Subscribe
shot: /assets/img/work/before.webp | 356x72 | Alt text
step: Tap Subscribe | The button shows a loading state.
stand-in: Login screen
shot: /assets/img/work/after.webp | 356x100 | Alt text
caption: What the reader should notice.
:::| Prop | Type | Default | Description |
|---|---|---|---|
flows | [{ title, steps }] | required | The flows, in order. Each step is { shot: { src, width, height, alt } }, { action, text } or { standIn }; text is an HTML string. |
caption | HTML string | none | The caption. |
Dot matrix
<dot-matrix>
Rows against columns in the theme's panel, with an accent dot where they meet and a faint dot where they don't. Each row has a strong label, an optional muted note under it and optional numbering.
Example
| Item | Group A | Group B | Group C | Group D |
|---|---|---|---|---|
| 1 Item oneA short note | Yes | Yes | Yes | No |
| 2 Item twoA short note | Yes | Yes | Yes | Yes |
| 3 Item three | Yes | No | No | No |
Which items cover which groups.
- When to use
- To show which items cover which groups, such as the layers of a system and the teams each one served.
- For values or amounts, use a table or a Flow diagram; the matrix only says yes or no.
- Variants
- Grid Columns side by side, when the figure is at least 36rem wide.
- Narrow Below 36rem each row becomes a block, listing only the columns it covers, each with its dot.
- Accessibility
- A real table: column headings and row labels are header cells, so each dot is announced with its row and column.
- Each dot carries a hidden Yes or No.
- Used on
Show usage and propsHide usage and props
::: matrix
corner: Layer
columns: Design | Product | Engineering
numbered: yes
row: Components | Figma, Storybook | x x x
row: Sample data | | x - -
caption: What the reader should notice.
:::| Prop | Type | Default | Description |
|---|---|---|---|
columns | [string] | required | The column headings. |
rows | [{ label, note?, marks }] | required | One per row. marks: one boolean per column. |
corner | string | required | The heading above the row labels. |
numbered | boolean | false | Numbers the rows from 1. |
caption | HTML string | none | The caption. |
Live link
<live-link>
A one-row panel sending the reader to a working version of the project: a Live project label, a title, one short sentence and a See it live button.
Example
- When to use
- Once per case study, as its closing element, after the Reflection.
- For a link inside a sentence, use a plain text link instead.
- Accessibility
- The button is a real link, and it opens in a new tab, which its up-right arrow signals.
- Below 40rem the button moves under the text.
- Used on
Show usage and propsHide usage and props
::: live-link
title: Project name
text: One short sentence on what the reader will find.
href: /path/to/project/
:::| Prop | Type | Default | Description |
|---|---|---|---|
title | string | required | The project's name. |
text | HTML string | required | One short sentence on what the reader will find. |
href | string | required | The live project. |
Flow diagram
<flow-diagram>
A coded diagram compared row by row: chains of labelled stops, counts drawn as blocks, or problems paired with their answers. Drawn with tokens, so it reprints in each theme. Every stop and link is the same size across rows, so a shorter process draws a shorter chain.
Example
Chains
- Start
- to Relay one
- to Relay two
- to End
- Start
- with End
A chain of steps, before and after, with relays dimmed.
Units
Each block is one unit.
Bars
Two amounts, drawn to scale.
Pairs
- First problem
- to Its answer
- Second problem
- to Its answer
Pinned
- Start
- to Relay
- to End
- to Check
-
1
At Relay: First issueWhat went wrong at this step.
-
2
From End back to Start: Second issueWhat went wrong on the way back.
- When to use
- To show how something moved through people or steps, or how a count changed, especially before and after.
- Build it only from facts already told in the case study, and keep estimates worded as estimates. For evidence of shipped work, use an Image figure.
- Variants
- Chains Stops joined by one-way or two-way links. A relay stop is dashed and muted: one the story questions.
- Long chain Automatic above four stops: tighter links, and a single column when the figure is too narrow for one line.
- Units A number in place of a chain draws equal blocks. Shorter rows show the difference as empty blocks.
- Bars "bar 540" in place of a chain draws a bar in true proportion to the largest one; "~bar" makes it hollow. The row's note states the value.
- Pairs Each row is a problem and its answer, as running text in two columns.
- Pinned Numbered markers on stops, on a dashed return path (which can stop at a cross, for something that never arrived), or on a bracket spanning several stops, tied to a legend under the chain. Use it when each point in a list happens at a place along a path.
- Accessibility
- Each chain is an ordered list of real text, so it needs no alt text.
- Connectors and unit blocks are hidden from assistive technology; a visually hidden word before each stop carries the direction, and a row's note states its count.
- In a narrow figure, chains turn 90 degrees and stand side by side, and pairs stack, so the comparison survives on phones.
- Used on
Show usage and propsHide usage and props
::: flow
row: Before | 3 steps | Start > ~Relay > End
row: After | 1 step | Start <> End
caption: What the reader should notice.
:::
::: flow
row: Before | About 5 sprints | 5
row: After | About 3 sprints | 3
:::
::: flow
arrangement: pairs
row: | | ~The problem > Its answer
:::
::: flow
row: | | Designer > ~Manager > Engineers
pin: 2 | Short label | What went wrong at this stop.
pin: 3 > 1 | Short label | What went wrong on the way back.
:::
(pin: 1-3 draws a bracket across stops 1 to 3; pin: 3 x 1 a path that stops at a cross.)| Prop | Type | Default | Description |
|---|---|---|---|
rows | [{ tag?, note?, nodes? | units? | bar?, ghost? }] | required | One comparison per row. nodes: [{ label, relay?, link? }], where link is the connector into that stop, "to" or "both". units: a number drawn as blocks. bar: a value drawn to scale. |
arrangement | "pairs" | none | Sets each two-stop row as a problem and its answer. |
pins | [{ n, label, text, where }] | none | The legend for markers set with node.pin or row.returnPath ({ from, to, pin, span?, broken? }). where is read out by assistive technology. |
caption | HTML string | none | What the reader should notice. |
Pull quote
<pull-quote>
A quote from a user or colleague, with its source: a ruled serif quote in Inspector, a highlighter band in Riso, a yellow card in Memphis.
Example
"A short quote from a user or stakeholder, in their own words."
- When to use
- For real words from real people, attributed. Never invented.
- Accessibility
- A <figure> with a <blockquote> and a <figcaption> for the source.
- Used on
Show usage and propsHide usage and props
> The quote in markdown.
> — Source, date
<pull-quote @source="Source, date">The quote.</pull-quote>| Prop | Type | Default | Description |
|---|---|---|---|
source | HTML string | none | Who said it, and where. |
CV blocks
The CV is a page like the others, and its PDF is that page printed. These blocks are what it adds: logos, the company wall and the entry card.
Logo tile
<logo-tile>
A company or school logo on a small square tile, shown as supplied in Inspector, in one navy ink in Riso, and as an outlined cut-out with an ink offset in Memphis.
Example
- When to use
- Beside the name of a company or school, never on its own and never larger than the name next to it.
- Variants
- Default 2.75rem, beside a card title.
- Small 2rem.
- Large 4rem, in the company wall.
- Accessibility
- Decorative: the image has an empty alt, since the name beside it says what it is.
- Used on
Show usage and propsHide usage and props
<logo-tile @src="/assets/img/logos/zaiko.png"></logo-tile>| Prop | Type | Default | Description |
|---|---|---|---|
src | string | required | A square logo file, in src/assets/img/logos/. |
size | "sm" | "lg" | none | Small or large. |
Company wall
<company-wall>
Where I've worked: one linked tile per company, newest first, with its logo, name, years and city. An overview of the career that is also the way into each entry.
- When to use
- Once, near the top of the CV, before the entries the tiles link to. Companies only: schools go under Education.
- Variants
- Print One row of six in the PDF.
- Accessibility
- A list of links, each named by the company, its years and city; the logo is decorative.
- Each link jumps to that company's entry.
- Used on
Show usage and propsHide usage and props
<company-wall :@items="cvView.wall"></company-wall>| Prop | Type | Default | Description |
|---|---|---|---|
items | [{ name, logo, years, location, href }] | required | From cvView.wall (src/_data/cvView.js). |
CV entry
<cv-entry>
One job or diploma: a card in three columns, hairlines between them. Who and when (the large logo beside the title, its years and its place on separate lines, the role and a line of context), the achievements as bullets, and the related case studies as a list of links. Stacked below 62rem.
Example
Company A
Job title
One line on what the company does.
- An achievement, with the figure that shows it: +5% on the measure.
- Another achievement, in one or two lines.
Case studies
- When to use
- For every job under Experience and every diploma under Education, newest first.
- Variants
- Job Title, meta, role, context, achievements, case studies.
- Diploma Title (the qualification), meta (years), place (school and city) and the original name as context.
- Empty columns A job without case studies, or a diploma without achievements, leaves that column out but keeps its place, so every card lines up.
- Accessibility
- An article with an h3 title, and an id the company wall links to.
- Achievements are a list; case study links are a list under a Case studies label, named by their titles.
- The columns follow the reading order: who and when, what, then where to read more.
- Used on
Show usage and propsHide usage and props
<cv-entry :@entry="job.card"></cv-entry>| Prop | Type | Default | Description |
|---|---|---|---|
entry | { id, logo, title, meta, place?, role?, context?, items?, cases? } | required | From cvView (src/_data/cvView.js): each job and diploma carries card. |
Accessibility
Every pair of colours that carries text is checked against WCAG AA (4.5:1) in every theme, at build time. Ratios shown are for the active theme.
| Pair | Sample | Ratio | AA |
|---|---|---|---|
| Text on page | Aa | 16.75:1 |
Pass |
| Text on surface | Aa | 18.27:1 |
Pass |
| Muted text on page | Aa | 6.22:1 |
Pass |
| Muted text on surface | Aa | 6.79:1 |
Pass |
| Link on surface | Aa | 6.11:1 |
Pass |
| Signal ink on surface | Aa | 5.63:1 |
Pass |
| On primary | Aa | 18.27:1 |
Pass |
| On highlight | Aa | 12.61:1 |
Pass |
| Text on page | Aa | 7.77:1 |
Pass |
| Text on surface | Aa | 8.82:1 |
Pass |
| Muted text on page | Aa | 5.62:1 |
Pass |
| Muted text on surface | Aa | 6.38:1 |
Pass |
| Link on surface | Aa | 8.82:1 |
Pass |
| Signal ink on surface | Aa | 8.82:1 |
Pass |
| On primary | Aa | 5.25:1 |
Pass |
| On highlight | Aa | 6.17:1 |
Pass |
| Text on page | Aa | 17.30:1 |
Pass |
| Text on surface | Aa | 18.42:1 |
Pass |
| Muted text on page | Aa | 10.48:1 |
Pass |
| Muted text on surface | Aa | 11.16:1 |
Pass |
| Link on surface | Aa | 18.42:1 |
Pass |
| Signal ink on surface | Aa | 18.42:1 |
Pass |
| On primary | Aa | 6.50:1 |
Pass |
| On highlight | Aa | 18.42:1 |
Pass |
- Focus. A 2px ring in the theme's focus colour, 3px off the edge, on every interactive element.
- Reduced motion. Transitions, the status pulse and smooth scrolling switch off.
- Structure. One h1 per page, landmarks for header, navigation, main and footer, and a skip link.
- No JavaScript needed to read. Only the theme switcher depends on it, and it stays hidden without it.