Ioan Sameli
One codebase, three themes

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
At a glance
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.
Contents

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.

  1. Primitives Raw values, named for what they are: a theme's inks, the spacing and type scales.
  2. Tokens Named for a job, pointing at a primitive. Every theme defines every one.
  3. Text styles Ten roles built from type tokens. Every piece of text uses one.
  4. 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.

The mark on its own, and beside the name as it sits in the header. Shown in the active theme.

Ioan Sameli

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.

The brand mark drawn on a 34-unit grid, with guides at its key lines
  • 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

WhereSizeSource
Site header36px (2.25rem)<brand-mark>
Link preview cards52px, 14px corners<brand-mark>
Browser tab 16 to 32pxsrc/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.

Bench Paper --inspector-paper #f6f5f1
Dot grid --inspector-dot #d3cfc4
White --inspector-white #ffffff
Tab Grey --inspector-tab #fbfaf7
Hairline --inspector-hairline #e1ded6
Graphite --inspector-graphite #5d5b55
Bench Ink --inspector-ink #151514
Heavy ink, raised --inspector-ink-raised #1f1f1d
Heavy ink, rule --inspector-ink-line #3a3935
Heavy ink, muted text --inspector-ink-muted #aaa79f
Heavy ink, text --inspector-ink-paper #f3f2ee
Signal Orange-Red --inspector-signal #f2541b
Signal Rust --inspector-rust #b83e0d
Annotation Yellow --inspector-yellow #ffd21f
Leader Ochre --inspector-ochre #c99a00
Inspector Teal --inspector-teal #0c6e66
Light Teal, links on heavy ink --inspector-teal-light #74d7c8
Status Teal --inspector-status #12a594
Riso Paper --riso-paper #e8e2d4
Riso Stock --riso-stock #f5f0e4
Riso Navy, the key plate --riso-navy #1b3d8c
Faded Navy --riso-navy-muted #3a5592
Fluorescent Pink --riso-pink #ff48b0
Pink Tint --riso-pink-tint #f8b9d8
Process Blue --riso-blue #0a67a8
Riso Yellow, the rare third ink --riso-yellow #ffe100
Memphis Cream --memphis-cream #fff7e8
White --memphis-white #ffffff
Memphis Ink --memphis-ink #141414
Memphis Muted --memphis-muted #3d3b38
Chalk, muted text on ink --memphis-chalk #e4e0d8
Memphis Pink --memphis-pink #ff5fa2
Memphis Yellow --memphis-yellow #ffd23f
Memphis Teal --memphis-teal #1fc7c7
Memphis Purple --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.

PrimitiveValueUsed 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

SampleTokenValueRole
--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

TokenValueRole
--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.

TokenValueRole
--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.

NameValueRole
--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, --gutterCentres content and pads its sides
.l-section--section-gapSpace above each top-level section
.l-rail12rem rail from 56remA sticky contents rail beside a main column
.l-flow--flow-space, default 1emEven space between stacked children
Breakpoints30rem · 48rem · 56rem · 62remSmall 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.

Aa --font-display Headings and figures "Instrument Serif", "Iowan Old Style", Georgia, serif "Archivo", "Arial Narrow", sans-serif "Bungee", "Arial Black", sans-serif
Aa --font-body Reading text "Geist", system-ui, sans-serif "Archivo", system-ui, sans-serif "Rubik", system-ui, sans-serif
Aa --font-mono Meta "Geist Mono", ui-monospace, "Cascadia Code", monospace "Space Mono", ui-monospace, monospace "Rubik", system-ui, sans-serif
Aa --font-label Labels var(--font-mono) var(--font-mono) "Rubik", system-ui, sans-serif
Aa --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.

Company name · 2020–2024

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

Ioan Sameli
One codebase, three themes
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
  • Every page
Show usage and propsHide usage and props
<site-header :@site="site" :@themes="themes" :@nav="nav" :@current="page.url"></site-header>
PropTypeDefaultDescription
site{ name }requiredSite name for the brand link.
themes[{ id, label }]requiredPassed to the theme switcher.
nav[{ label, href }]requiredMain navigation, from src/_data/nav.json.
currentstringrequiredThe 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
  • CV
  • Inside <site-header>
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
  • Inside <site-header>
Show usage and propsHide usage and props
<theme-switcher :@themes="themes"></theme-switcher>
PropTypeDefaultDescription
themes[{ id, label }]requiredFrom src/_data/themes.json.

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
  • Every page
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

Back

Project title

One sentence that says what the project was and why it mattered.

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
  • 404
  • CV
  • Home
  • Case studies
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>
PropTypeDefaultDescription
titlestringrequiredThe page's h1.
leadstringnoneThe line under the title.
size"hero" | "page""page"Which heading role the title takes.
anchorstringnoneAn 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
  • Home
Show usage and propsHide usage and props
<page-section id="about" @title="About">
  <p>Section content.</p>
</page-section>
PropTypeDefaultDescription
idstringrequiredThe section's anchor. The title gets <id>-title.
titlestringrequiredThe 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
  • CV
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.

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
  • Case studies
Show usage and propsHide usage and props
<div class="l-container l-rail">
  <page-contents :@items="toc"></page-contents>
  <div>…sections…</div>
</div>
PropTypeDefaultDescription
items[{ id, title, items? }]requiredOne entry per section heading, with one optional level of nested entries.
openbooleanfalseRender 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.

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
  • Case studies
Show usage and propsHide usage and props
<case-pager :@prev="study.prev" :@next="study.next"></case-pager>
PropTypeDefaultDescription
prev{ url, title } | nullrequiredThe previous case study.
next{ url, title } | nullrequiredThe 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

Panel label
  • Tag one
  • Tag two
  • Tag three
Highlights
1,234
what the number counts, in a short phrase
Project name, Company
At a glance Status message
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
  • Tool one
  • Tool two
  • Tool three
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
  • CV
  • Home
  • Case studies
  • Inside <glance-panel>
Show usage and propsHide usage and props
<info-panel @label="Highlights" @variant="heavy">
  <metric-list :@items="highlights"></metric-list>
</info-panel>
PropTypeDefaultDescription
labelstringrequiredThe text in the label strip.
variant"heavy"noneThe inverted, page-anchoring panel.
statusstringnoneA 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

At a glance Status message

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
  • Tool one
  • Tool two
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
  • CV
  • Home
Show usage and propsHide usage and props
<glance-panel :@glance="glance"></glance-panel>
PropTypeDefaultDescription
glance{ status, photo, photoAlt, name, title, years, facts }requiredFrom src/_data/glance.js.
linksbooleanfalseShow Read the CV and Download PDF.
pdfstringnoneThe PDF's URL, with links.
rows[{ label, value, href? }]noneRows 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

    • Tag one
    • Tag two

    Project title

    One or two sentences on the problem and what changed.

    +5% the result, in a short phrase

    • Tag one
    • Tag three

    Another project title

    One or two sentences on the problem and what changed.

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
  • Home
Show usage and propsHide usage and props
<work-cards :@items="work"></work-cards>
PropTypeDefaultDescription
items[{ url, title, summary, company, timeline, tags, figure?, note?, hero?, slot? }]requiredFrom 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

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
  • CV
  • Home
  • Case studies
  • Inside <glance-panel>
Show usage and propsHide usage and props
<fact-list :@items="[{ label: 'Role', value: 'Lead designer' }]"></fact-list>
PropTypeDefaultDescription
items[{ label, value?, href?, tags?, lines?, terms? }]requiredRows. 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"noneRoomier 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

1,234
what the number counts, in a short phrase
Project name, Company
+5%
the change it measures, in a short phrase
Project name, Company

Compact

1,234
what the number counts, in a short phrase
Project name, Company
+5%
the change it measures, in a short phrase
Project name, Company
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
  • CV
  • Home
  • Case studies
Show usage and propsHide usage and props
<metric-list :@items="highlights" @density="compact"></metric-list>
PropTypeDefaultDescription
items[{ value, label, source?, url? }]requiredOne row per figure.
density"compact"noneValue above label.

Tag list

<tag-list>

Short topic labels in a wrapping row.

Example

  • Tag one
  • Tag two
  • Tag three
  • Tag four
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
  • Home
  • Inside <fact-list>
  • Inside <work-cards>
Show usage and propsHide usage and props
<tag-list :@tags="['Design systems', 'Front-end']"></tag-list>
PropTypeDefaultDescription
tags[string]requiredThe labels.
labelstring"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

Leader up Leader down Leader right Leader left 1In a legend
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
  • Home
  • Inside <image-figure>
  • Inside <site-header>
  • Inside <work-cards>
Show usage and propsHide usage and props
<pinned-note @side="up">Exact figures, never rounded up</pinned-note>
PropTypeDefaultDescription
side"up" | "down" | "left" | "right" | "none""down"Where the leader points.
labelstringslotThe text, when it comes from data.
numberstringnoneA 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
  • Inside <fact-list>
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>
PropTypeDefaultDescription
labelstringrequiredThe trigger text.
tipstringrequiredThe annotation's first line.
metastringnoneA 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

Location · Status message

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
  • Inside <glance-panel>
  • Inside <info-panel>
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
  • Inside <work-cards>
Show usage and propsHide usage and props
<p><inline-metric @value="42" @label="items counted, in a short phrase"></inline-metric></p>
PropTypeDefaultDescription
valuestringrequiredThe exact figure.
labelstringrequiredWhat it counts.

Actions

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
  • CV
  • Inside <arrow-link>
  • Inside <case-pager>
  • Inside <image-zoom>
  • Inside <link-button>
  • Inside <work-cards>
Show usage and propsHide usage and props
<line-icon @name="arrow-right"></line-icon>
PropTypeDefaultDescription
name"arrow-right" | "arrow-left" | "arrow-up-right" | "download" | "expand" | "close"requiredWhich 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
  • Case studies (from markdown)
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>
PropTypeDefaultDescription
titleHTML stringrequiredWhat the side quest is about.
overviewHTML stringnoneOne sentence under the title, in the header strip. Required in case studies.
idstringrequiredThe 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

Before After
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
  • Inside <flow-diagram>
  • Inside <image-figure>
  • Inside <step-flows>
Show usage and propsHide usage and props
<figure-tag @label="Before"></figure-tag>
PropTypeDefaultDescription
labelstringrequiredThe 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

1 2
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
  • Inside <flow-diagram>
  • Inside <image-figure>
Show usage and propsHide usage and props
<figure-marker :@number="1"></figure-marker>
PropTypeDefaultDescription
numbernumberrequiredMatches 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

  1. 1What the marker points at

What the reader should notice in the figure.

Three images

Placeholder screenshot Enlarge image First state
Placeholder screenshot Enlarge image Second state
Placeholder screenshot Enlarge image Third state

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
  • Case studies (from markdown)
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.
:::
PropTypeDefaultDescription
images[{ src, width, height, alt, label?, large?, markers? }]requiredOne, two or three images. large: a bigger file for the enlarged view. markers: [{ n, x, y }] in percent.
notes[{ n, label }]noneThe legend.
captionHTML stringnoneThe caption.
illustrationSVG stringnoneA one-off drawing, instead of images. From markdown, a file in content/illustrations; alt text is required.
placeholderstringnoneA 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.

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
  • Inside <image-figure>
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>
PropTypeDefaultDescription
src, width, height, altstringrequiredThe image, as for an img.
largestringsrcA 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

Placeholder screenshot
Card one
What the feature does, in one sentence.
Placeholder screenshot
Card two
What the feature does, in one sentence.
Placeholder screenshot
Odd last card
With an odd number of cards, the last one lies flat across the full width.
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
  • Case studies (from markdown)
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
:::
PropTypeDefaultDescription
cards[{ src, width, height, alt, title, text, link? }]requiredThe 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

Flow one
  1. Placeholder: a button
  2. Tap the button Another screen opens.
  3. Another screen
  4. Complete it The visitor returns to the page, in the new state.
  5. Placeholder: a message above a button
Flow two
  1. Placeholder: a message above a button
  2. Tap the button The button shows a loading state.
  3. Placeholder: the same message and button
  4. Request processed The component returns to its first state, and a message confirms.
  5. Placeholder: a button, with a message bar at the bottom

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
  • Case studies (from markdown)
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.
:::
PropTypeDefaultDescription
flows[{ title, steps }]requiredThe flows, in order. Each step is { shot: { src, width, height, alt } }, { action, text } or { standIn }; text is an HTML string.
captionHTML stringnoneThe 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
  • Case studies (from markdown)
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.
:::
PropTypeDefaultDescription
columns[string]requiredThe column headings.
rows[{ label, note?, marks }]requiredOne per row. marks: one boolean per column.
cornerstringrequiredThe heading above the row labels.
numberedbooleanfalseNumbers the rows from 1.
captionHTML stringnoneThe caption.

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

Before 3 steps
  1. Start
  2. to Relay one
  3. to Relay two
  4. to End
After 1 step
  1. Start
  2. with End

A chain of steps, before and after, with relays dimmed.

Units

Before About 5 units
After About 3 units

Each block is one unit.

Bars

Larger amount, 500
Smaller amount, 70

Two amounts, drawn to scale.

Pairs

  1. First problem
  2. to Its answer
  1. Second problem
  2. to Its answer

Pinned

  1. Start
  2. to Relay
  3. to End
  4. to Check
  1. 1
    At Relay: First issue
    What went wrong at this step.
  2. 2
    From End back to Start: Second issue
    What 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
  • Case studies (from markdown)
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.)
PropTypeDefaultDescription
rows[{ tag?, note?, nodes? | units? | bar?, ghost? }]requiredOne 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"noneSets each two-stop row as a problem and its answer.
pins[{ n, label, text, where }]noneThe legend for markers set with node.pin or row.returnPath ({ from, to, pin, span?, broken? }). where is read out by assistive technology.
captionHTML stringnoneWhat 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."

Source name, date
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
  • Case studies (from markdown)
Show usage and propsHide usage and props
> The quote in markdown.
> — Source, date

<pull-quote @source="Source, date">The quote.</pull-quote>
PropTypeDefaultDescription
sourceHTML stringnoneWho 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
  • Inside <company-wall>
  • Inside <cv-entry>
Show usage and propsHide usage and props
<logo-tile @src="/assets/img/logos/zaiko.png"></logo-tile>
PropTypeDefaultDescription
srcstringrequiredA square logo file, in src/assets/img/logos/.
size"sm" | "lg"noneSmall 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
  • CV
Show usage and propsHide usage and props
<company-wall :@items="cvView.wall"></company-wall>
PropTypeDefaultDescription
items[{ name, logo, years, location, href }]requiredFrom 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
  • CV
Show usage and propsHide usage and props
<cv-entry :@entry="job.card"></cv-entry>
PropTypeDefaultDescription
entry{ id, logo, title, meta, place?, role?, context?, items?, cases? }requiredFrom 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.

PairSampleRatioAA
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.