Atoms
01
Headings
H1 to H4, and the one-H1-per-page rule.
This page does not exist.
- The title as plain text, from two words to one sentence: "Claude Narrator", "This page does not exist."
- Component
H1- Import
ui/typography(in apps/web also@/app/components/ui/typography)- What it is
- The page title: an
<h1>at 1.875rem, 2.375rem from 767px, in the colourclassNamegives it. - Use when
- The one title of a page.
SectionHero,ArticleHeroandBlogHerohold it on www. - Never
- A second one on a page, since a page has one title; in an article's body, where the hero owns it; a heading rebuilt with
text-[…](§3).
| Prop | Type | Use it for | Never |
|---|---|---|---|
| className | string | Colour and alignment: text-black, text-center. | Size, weight or spacing, which the scale sets (§3). |
- Children
ReactNode· required. The title as plain text, from two words to one sentence: "Claude Narrator", "This page does not exist." Never: a link or an icon inside it; a second sentence.
- Example
<H1 className="text-black">This page does not exist.</H1>
import { H1 } from "ui/typography";
<H1 className="text-black">This page does not exist.</H1>About me
- The section's name as plain text, one to six words: "About me", "Previous work".
- Component
H2- Import
ui/typography(in apps/web also@/app/components/ui/typography)- What it is
- A section heading: an
<h2>at 1.375rem, 1.75rem from 767px, in the colourclassNamegives it. - Use when
- Titling a section of a page.
SectionAbout,SectionWorkandArticleFaqopen with one. - Never
- Rebuilt with
text-[…], since the scale is the components (§3); as a list entry's title, which is anH3.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| className | string | Colour and alignment: text-black, text-center. | Size, weight or spacing, which the scale sets (§3). |
- Children
ReactNode· required. The section's name as plain text, one to six words: "About me", "Previous work". Never: a link inside it; a sentence, which is aP.
- Example
<H2 className="text-black">About me</H2>
import { H2 } from "ui/typography";
<H2 className="text-black">About me</H2>Product principles
- An entry's or a column's title as plain text: "Product principles", an article's title.
- Component
H3- Import
ui/typography(in apps/web also@/app/components/ui/typography)- What it is
- A sub-section heading: an
<h3>at 1.25rem, in the colourclassNamegives it. - Use when
- A list entry's title or a column heading under a section heading.
ListEntry,Section2ColumnTextandFooteruse it. - Never
- Rebuilt with
text-[…](§3); as a page section's title, which is anH2.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| className | string | Colour and alignment: text-black, text-dark-grey. | Size, weight or spacing, which the scale sets (§3). |
- Children
ReactNode· required. An entry's or a column's title as plain text: "Product principles", an article's title. Never: a link inside it, sinceListEntrylinks the whole entry; body text.
- Example
<H3 className="text-black">Product principles</H3>
import { H3 } from "ui/typography";
<H3 className="text-black">Product principles</H3>A heading under an H3
- A short plain-text heading, one to six words; only an article's
####line becomes one, and none does yet.
- Component
H4- Import
ui/typography(in apps/web also@/app/components/ui/typography)- What it is
- A minor heading: an
<h4>at 1.1rem, in the colourclassNamegives it. - Use when
- A heading under an
H3.BlockHeadingdraws a level-4 block with it. - Never
- Rebuilt with
text-[…](§3); as the first heading of a section, which is anH2.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| className | string | Colour and alignment: text-black. | Size, weight or spacing, which the scale sets (§3). |
- Children
ReactNode· required. A short plain-text heading, one to six words; only an article's####line becomes one, and none does yet. Never: a link; body text, which is aP.
- Example
<H4 className="text-black">A heading under an H3</H4>
import { H4 } from "ui/typography";
<H4 className="text-black">A heading under an H3</H4>02
Body text
P, PSmall and PXSmall, and when dark grey is allowed to carry a line.
Today I’m a Product Design Lead at Pigment, where we build AI agents for the world of EPM and FP&A.
- The sentences of one paragraph, with a
TextLinkor aCodeTextinline where the copy needs one: "Today I’m a Product Design Lead at Pigment, where we build AI agents for the world of EPM and FP&A."
- Component
P- Import
ui/typography(in apps/web also@/app/components/ui/typography)- What it is
- Body text: a
<p>at 0.95rem, 1rem from 767px, in the colourclassNamegives it. 60 to 80 characters a line reads best. - Use when
- Running copy: a paragraph, an intro, the line under a title.
SectionAbout,Section2ColumnTextandSectionDotGlobeset their text with it. - Never
classNamefor anything but colour and alignment (§3); a heading, which isH1toH4; a caption or an intro, which isPSmall.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| className | string | Colour and alignment: text-black, text-dark-grey, text-center. | Size, weight or line height, which the scale sets (§3). |
- Children
ReactNode· required. The sentences of one paragraph, with aTextLinkor aCodeTextinline where the copy needs one: "Today I’m a Product Design Lead at Pigment, where we build AI agents for the world of EPM and FP&A." Never: a heading or a list; a second paragraph, which is its ownP.
- Example
<P className="text-black">Today I’m a Product Design Lead at Pigment, where we build AI agents for the world of EPM and FP&A.</P>
import { P } from "ui/typography";
<P className="text-black">
Today I’m a Product Design Lead at Pigment, where we build AI agents for the world of EPM and FP&A.
</P>I like to document what I learn and build.
- One to three sentences of plain text: a caption, an intro, a label: "Pigment Platform", "I like to document what I learn and build."
- Component
PSmall- Import
ui/typography(in apps/web also@/app/components/ui/typography)- What it is
- Secondary text: a
<p>at 0.875rem, in the colourclassNamegives it. - Use when
- A caption, a list entry's intro, the label beside a hero's title.
SectionHero,SectionBlogandListEntryset theirs with it. - Never
classNamefor anything but colour and alignment (§3); running copy, which isP; a date or a label, which isPXSmall.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| className | string | Colour and alignment: text-dark-grey, text-black. | Size, weight or line height, which the scale sets (§3). |
- Children
ReactNode· required. One to three sentences of plain text: a caption, an intro, a label: "Pigment Platform", "I like to document what I learn and build." Never: a heading; a long paragraph, which isP.
- Example
<PSmall className="text-dark-grey">I like to document what I learn and build.</PSmall>
import { PSmall } from "ui/typography";
<PSmall className="text-dark-grey">
I like to document what I learn and build.
</PSmall>21 October 2026 · 6 min read
- A few words of plain text: "21 October 2026 · 6 min read", "01".
- Component
PXSmall- Import
ui/typography(in apps/web also@/app/components/ui/typography)- What it is
- Metadata text: a
<p>at 0.75rem, in the colourclassNamegives it. - Use when
- A date, a read time, a small label.
ListEntry,BlogHeroandPinnedPostsset their dates with it. - Never
classNamefor anything but colour and alignment (§3); a caption, which isPSmall; anything a reader must not miss, since it is small and often dark grey (§10).
| Prop | Type | Use it for | Never |
|---|---|---|---|
| className | string | Colour and alignment: text-dark-grey, tabular-nums for a number. | Size, weight or line height, which the scale sets (§3). |
- Children
ReactNode· required. A few words of plain text: "21 October 2026 · 6 min read", "01". Never: a sentence; a heading.
- Example
<PXSmall className="text-dark-grey">21 October 2026 · 6 min read</PXSmall>
import { PXSmall } from "ui/typography";
<PXSmall className="text-dark-grey">
21 October 2026 · 6 min read
</PXSmall>03
Inline code
CodeText, for code inside running text.
Start the app with npm run dev:app, then open the design system.
- The code as plain text, a few characters to one line: "npm run dev:app", "t-h1".
- Component
CodeText- Import
ui/typography(in apps/web also@/app/components/ui/typography)- What it is
- Inline code: a
<code>at 0.8rem in the monospace face, in the colourclassNamegives it, inside running text. - Use when
- A command, a file name or a token named inside a sentence. Nowhere yet.
- Never
- A block of code, which is
CodeBlock;classNamefor anything but colour (§3).
| Prop | Type | Use it for | Never |
|---|---|---|---|
| className | string | Colour: text-black. | Size or face, which the scale sets (§3). |
- Children
ReactNode· required. The code as plain text, a few characters to one line: "npm run dev:app", "t-h1". Never: a sentence; a link; a line break.
- Example
<CodeText>npm run dev:app</CodeText>
import { CodeText } from "ui/typography";
<CodeText>npm run dev:app</CodeText>04
Links
The plain text link, underlined in running text.
- A route of the site, or a full URL, which opens in a new tab.
- Adds
nofollowtorel; when the site should not vouch for the page linked. blackin running text;dieter, black on hover, in a table cell, whereTablesets it.- The words of the sentence that name the destination, plain text: "home page", "blog".
- Component
TextLink- Import
ui/link- What it is
- The plain text link: black, underlined, dark grey on hover, or dieter orange and black on hover in a table cell. It opens a new tab when
hrefleaves the site. - Use when
- A link in running text, the default link (§7).
not-found.tsxof www and of the app use it. - Never
- Without its underline, since a link looks like a link (§7); as a button, which is a
Button; as the one action of a view, which isTextLinkDieter.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| href | string · required | A route of the site, or a full URL, which opens in a new tab. | |
| no_follow | boolean · default false | Adds nofollow to rel; when the site should not vouch for the page linked. | On a route of the site. |
| color | "black" | "dieter" · default "black" | black in running text; dieter, black on hover, in a table cell, where Table sets it. | dieter in running text, since orange marks the one place to act (§1). |
- Children
ReactNode· required. The words of the sentence that name the destination, plain text: "home page", "blog". Never: "click here"; a whole sentence; an icon.
- Example
<TextLink href="/">home page</TextLink>
import { TextLink } from "ui/link";
<TextLink href="/">home page</TextLink>05
Buttons
Text with a hover effect: dark grey at rest, black on hover, no fill or box. The primary one trails the dieter dot; a disabled one fades.
- Turns the text black with the dieter dot after it; for the one action a view exists for.
- The action as a verb phrase, plain text: "Sign in", "Copy JSON to clipboard". Two to four words.
- Component
Button- Import
ui/button- What it is
- A text button: dark grey at rest, black on hover, no fill, border or box (§8), faded when disabled. With
primaryit is black and the dieter dot trails the text. - Use when
- An action that is not navigation: submitting, copying, toggling.
/login,/backoffice/clientsand/unlockuse it. - Never
- For navigation, which is a link;
primarytwice in one view, since a view has one action (§7); a fill, a border or a box throughclassName, since a button is text (§8). - Native props
- every
<button>prop passes through.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| primary | boolean · default false | Turns the text black with the dieter dot after it; for the one action a view exists for. | A cancel, or a second action in the same view (§7). |
| className | string | Space around it. | Colour, a fill or a border (§8). |
| type | "submit" | "reset" | "button" · native | submit for the form's own action, reset nowhere, button for every other, so Enter in a field fires only the form's. | Left out: the browser defaults to submit. |
| disabled | boolean · native | Fades the button and stops it responding; when the action cannot run yet. | To hide an action, which is taken out instead. |
- Children
ReactNode. The action as a verb phrase, plain text: "Sign in", "Copy JSON to clipboard". Two to four words. Never: an icon alone, which needs anaria-label(§10); a sentence; a page's name, which is a link.
- Example
<Button type="submit" primary>Sign in</Button>
import { Button } from "ui/button";
<Button type="submit" primary>Sign in</Button>06
The dieter accent
The orange circle CTA and the small trailing dot, the one place a view asks you to act. A view spends one; this tab shows every accent at once because it is the catalogue.
- The route the action opens:
/blog,/about, a section's page. - The action as a verb or a noun, one to three words, also the link's
aria-label: "All articles".
- Component
BtnDieterCircle- Import
ui/btn-dieter-circle- What it is
- The orange disc call to action: the text on an orange disc that slides on hover, over a label that gives it its width. 132px across, 156px from 767px.
- Use when
- The one action a view exists for, when the Dieter visual is the point (§7).
SectionAbout,SectionBlogandBlogHeroplace one. - Never
- More than one per view (§7); where a plain
next/linkwould do, since the site is built for search (§7); as a form's submit, which is aButton.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| link | string · required | The route the action opens: /blog, /about, a section's page. | A URL off the site, since the circle is the site's own move. |
| text | string · required | The action as a verb or a noun, one to three words, also the link's aria-label: "All articles". | A sentence, since it has to fit the disc. |
- Example
<BtnDieterCircle link="/blog" text="All articles" />
import { BtnDieterCircle } from "ui/btn-dieter-circle";
<BtnDieterCircle link="/blog" text="All articles" />- The route or URL the link opens: a page of the site, or the hiring page off it.
- The action as a verb phrase, one to four words, the link's whole text: "Hiring".
- Opens the link in a new tab, with
relset safe; whenhrefleaves the site. - Adds
nofollowtorel; when the site should not vouch for the page. Only withopen_new_tab.
- Component
TextLinkDieter- Import
ui/text-link-dieter- What it is
- A text link trailed by a small orange dot that floods into a pill on hover. Black text in an
<a>. - Use when
- A primary action that should read as a link, not a circle (§7).
Navbarplaces one, the hiring link. - Never
- As a default link, which is a plain
next/linkorTextLink(§7); twice in one view, since a view spends the orange once (§1).
| Prop | Type | Use it for | Never |
|---|---|---|---|
| href | string · required | The route or URL the link opens: a page of the site, or the hiring page off it. | |
| text | string · required | The action as a verb phrase, one to four words, the link's whole text: "Hiring". | A sentence. |
| open_new_tab | boolean · default false | Opens the link in a new tab, with rel set safe; when href leaves the site. | On a route of the site. |
| no_follow | boolean · default false | Adds nofollow to rel; when the site should not vouch for the page. Only with open_new_tab. | On a route of the site. |
- Example
<TextLinkDieter href="https://refer.hellotrusty.io/uwh99baf7r" text="Hiring" open_new_tab no_follow />
import { TextLinkDieter } from "ui/text-link-dieter";
<TextLinkDieter href="https://refer.hellotrusty.io/uwh99baf7r" text="Hiring" open_new_tab no_follow />07
Inputs
A single hairline underneath, on the grey page.
- Component
Input- Import
ui/input- What it is
- The text input: one hairline underneath on the grey page, black on focus, the placeholder in dark grey. A native
<input>with thefieldclass. - Use when
- A single-line field in a form, inside a
Fieldfor its label./loginand/unlockuse it. - Never
- A box, a fill or a white background (§8); a checkbox or a textarea, which it does not draw; without a label, which
Fieldgives it (§10). - Native props
- every
<input>prop passes through.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| className | string | Width or space around it: max-w-[400px]. | A border, a fill or a radius (§8). |
| placeholder | string · native | When the shape is not obvious: a sample value in the field's shape, in dark grey, "name@example.com". | The label, which Field draws above it (§8). |
| disabled | boolean · native | Stops typing; when the value cannot change yet. It does not fade. | To hide a field, which is taken out instead. |
- Example
<Input type="email" name="email" placeholder="name@example.com" />
import { Input } from "ui/input";
<Input type="email" name="email" placeholder="name@example.com" />08
Icons
The 20px line icons at a 1.5 stroke: the side nav's, the FAQ's and the globe's, from one set.
- home
- narrator
- bud-a
- snake
- design-system
- back-office
- door
- bills
- work
- contact
- copy
- pencil
- check
- trash
- info
- warning
- plus
- minus
- chevron
- saved
- close
- arrow-left
- toggle-on
- toggle-off
- wave-height
- heading
- compass
- breaking
- depth
- above
- period
- tide
- wavelength
- power
- grid
- Component
Icon- Import
ui/icon- What it is
- A 20px line icon at a 1.5 stroke in the text's colour, always
aria-hidden. One of the seticonNameslists. - Use when
- Beside a label, or inside a control that has an
aria-label.NavItem,ArticleFaqandComponentPreviewuse it. - Never
- Alone as the only name of a control (§10); a new inline SVG, which is an entry in the set instead; a colour of its own, since it takes the text's.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| name | IconName · required | Which icon of the set, as home, pencil or arrow-left. iconNames lists them all and the design system draws each. | |
| className | string | Size, as size-4 for a smaller one, and the stroke scales with it. | A colour, which the text beside it sets. |
- Example
<Icon name="copy" />
import { Icon } from "ui/icon";
<Icon name="copy" />09
Icon key
The one button with a surface: a plate a shade off the page, a dish pressed into it and an icon, like a key on an OP-1. Three sizes, five colours; hover presses it in.
- Component
IconButton- Import
ui/icon-button- What it is
- A key like one on an OP-1: a rounded square plate a shade off the page, rimmed by a thin line, a round dish pressed into it, one
Iconat its centre. Hover presses it in. Three sizes, five colours. - Use when
- An action that is one word and has an icon in the set, beside a list's or a section's title: "+" to add. Nowhere yet.
- Never
- The one action a view exists for, which is
Buttonprimary; a form's submit; an action inside a table cell, which isCellAction. - Native props
- every
<button>prop passes through.
| Prop | Type | Use it for | Never |
|---|---|---|---|
| icon | IconName · required | The sign on the key: plus, minus, close. | An icon the set lacks, which is an entry in the set (§10). |
| label | string · required | What the key does, as the accessible name and the tooltip: "Add a service". | A sentence. |
| size | "xsmall" | "small" | "medium" · default "medium" | medium beside a title; small inside a band; xsmall inline with small text, as beside a list's title. | |
| color | "grey" | "dark-grey" | "white" | "orange" | "black" · default "grey" | grey on the page; dark-grey to read darker; white to stand out; orange for a view's one key; black on a black fill. | Two oranges in one view (§7). |
| className | string | Where it sits. | A colour or a size, which the props set. |
| disabled | boolean · native | Fades the key and stops it responding; when the action cannot run yet. | To hide an action, which is taken out instead. |
- Example
<IconButton icon="plus" label="Add a service" size="xsmall" />
import { IconButton } from "ui/icon-button";
<IconButton icon="plus" label="Add a service" size="xsmall" />