<p class="cap-muted">A hold reason is a sentence, so it wraps in its own column (<code>data-wrap</code>) and the glyph stays by its first line.</p>
<div class="status-sample-narrow">
<span class="cap-status" data-tone="warn" data-wrap id="sample-wrap"><svg class="cap-status-glyph" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" fill-rule="evenodd" d="M4 1.5h8A2.5 2.5 0 0 1 14.5 4v8a2.5 2.5 0 0 1-2.5 2.5H4A2.5 2.5 0 0 1 1.5 12V4A2.5 2.5 0 0 1 4 1.5zM5.7 4.8h1.5v6.4H5.7zM8.8 4.8h1.5v6.4H8.8z"/></svg>Held until a person approves the change to the billing settings for example.com</span>
</div>
A glyph on its own
<p class="cap-muted">A status icon beside a name, with no word of its own, takes its tone's color (<code>data-tone</code> on the glyph). The name beside it, or a hidden word, says the state.</p>
<ul class="status-sample-list" aria-label="Glyphs on their own" id="sample-glyph">
<li><svg class="cap-status-glyph" data-tone="ok" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" fill-rule="evenodd" d="M8 1a7 7 0 1 0 0 14A7 7 0 1 0 8 1zM3.9 9l3 3 5.2-5.6-1.4-1.4-3.8 4.2-1.6-1.6z"/></svg> example.com<span class="cap-sr-only"> is up</span></li>
<li><svg class="cap-status-glyph" data-tone="crit" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" fill-rule="evenodd" d="M5 1h6l4 4v6l-4 4H5l-4-4V5zM7.2 4h1.6v5H7.2zM7.2 10.4h1.6V12H7.2z"/></svg> api.example.com<span class="cap-sr-only"> is down</span></li>
</ul>
Accent and series badges
<p class="cap-muted">The accent variant is a category that is not a state, with no glyph; <code>data-family</code> gives it another family's accent. A series dot colors a label a person made, the word beside it carrying the meaning.</p>
<div class="cap-specimen-row" id="sample-accent">
<span class="cap-pill" data-variant="accent">Win-back</span>
<span class="cap-pill" data-variant="accent" data-family="purple">Win-back, in the purple family</span>
</div>
<div class="cap-specimen-row" id="sample-series">
<span class="cap-pill" data-variant="outline" data-series="1"><span class="cap-pill-dot" aria-hidden="true"></span>Draft</span>
<span class="cap-pill" data-variant="outline" data-series="2"><span class="cap-pill-dot" aria-hidden="true"></span>In review</span>
<span class="cap-pill" data-variant="outline" data-series="3"><span class="cap-pill-dot" aria-hidden="true"></span>Revised</span>
<span class="cap-pill" data-variant="outline" data-series="4"><span class="cap-pill-dot" aria-hidden="true"></span>Final</span>
</div>
<h2 id="s-tag">Tag badges</h2>
<p class="cap-muted">A tag is set in the site's tag face (<code>--tag-*</code>): the tone's tint with an edge in its own color, a quiet hairline label with no tone, or a family's accent. These set mono, upper case and no glyph, as Foxhound does.</p>
<div class="cap-specimen-row" id="sample-tag" style="--tag-face: var(--mono); --tag-case: uppercase; --tag-tracking: var(--tracking-widest); --tag-weight: var(--weight-regular)">
<span class="cap-pill" data-variant="tag" data-tone="ok">Retries automatically</span>
<span class="cap-pill" data-variant="tag" data-tone="crit">Never retried</span>
<span class="cap-pill" data-variant="tag">Needs card update</span>
<span class="cap-pill" data-variant="tag" data-family="purple">Reactivated</span>
</div>
The word: "Critical", "Down", "2 blocked". Never empty: the word is the status.
glyph
GlyphName
The mark of a state or kind of item that has its own shape (queued, blocked, a pull request); the tone still sets the color. Without it the tone's own glyph.
reason
ReactNode
No data says why: "the counter has not reported since 09:00".
brief
boolean
For a table cell, where a sentence does not fit: the cell says the word and nothing more, the reason is read out by a screen reader (and shown on hover, when it is text), and the full sentence is in the row's detail. The Portal's NoData brief (design D18).
wrap
boolean
A phrase that wraps in its own column (a hold reason) instead of staying on one line; the glyph stays at the first line.
Pill
Prop
Type
Required
Does
tone
Tone
A status tone: the word and glyph on the tone's tint. Without a variant it is a status badge; with one, outline and ghost keep the tone's color.
variant
BadgeVariant
shadcn's badge variants. Leave out for the tinted status badge (or a quiet gray one).
running
boolean
Running is an info tone drawn with an arc.
glyph
GlyphName | false
The mark of a state or kind that has its own shape; the tone sets the color. false leaves the glyph out, for a site whose badges are words alone: the word must then say the state.
series
1 | 2 | 3 | 4 | 5 | 6 | 7 | 8
A dot in the series color 1 to 8, before the word: a label the person colored (a status list's labels). The word carries the meaning; the dot only repeats it. Give it with a variant (outline for the quiet edge).
family
string
The color family of this badge's accent: "purple", "amber" and the rest of Capsomer's families. A site's own hue for the accent variant, kept in tokens.
children
ReactNode
Yes
The word. A badge with a tone also draws that tone's glyph, so shape and word carry it.
href
string
A link badge: a real <a>. Its hit area grows to the target size.
onClick
() => void
A button badge. Give href or onClick, not both.
Functions
Function
Signature
Does
glyphParts
(name: GlyphName): string
A glyph's inner elements as markup, for a page that draws it inside its own <svg> (a box in a graph at 12 px).
glyphHtml
(name: GlyphName): string
The glyph as the status draws it: hidden from assistive technology, since the word says it.
The conclusion of a run (a CI check, a build, a backup copy, a scheduled task) as a status. The words are GitHub's check-run conclusions and Cloudflare's build outcomes, which cover the rest: success and neutral are ok, skipped did not run (no data), canceled and timed out stopped before an answer (warning), and every other conclusion failed. No conclusion yet is running. A site that words a state its own way passes labels ("Built", "Green").