Fact
Single headline value with a short label, optional eyebrow above and optional description below. Used as a building block for marketing reassurance rows, dashboard KPI summaries, and quick stats, composed by the consumer with the project grid utility. Four sizes, sm, md (default), lg, xl, scale the value font and the card padding. Place lg or xl in a wider grid cell (e.g. col-md-6) so the prominence has room to land.
Usage
When to use
- A single number, ratio, or short symbol that deserves prominence on its own
- Marketing reassurance rows (uptime, customer count, response time)
- Dashboard KPI summaries that need scannable headline figures
When not to use
- A long sentence or several values in one block - use card or content instead
- A measurable in-progress task - use progress
- Editorial content with images and CTAs - use card
Do
- Keep the value short - aim for 5 characters or less so it stays a headline
- Pair
lgandxlsizes with a wider grid cell so the value has room to land - Use the supertitle for unit context (
p99,median) and the description for caveats
Don't
- Don't put multiple sentences inside the label
- Don't use
xlin a four-up row - it crowds the layout - Don't repeat the same supertitle across every fact in a row - move it to the row heading
API
Slots
| Slot | Required | Description |
|---|---|---|
value | Yes | The headline number or short symbol (for example "14ms", "99.99%", "4.7 stars", "FSCS"). |
label | Yes | One-line caption describing the value. |
supertitle | - | Optional eyebrow above the value (for example "p99", "median"). |
description | - | Optional second line below the label. |
Props
| Prop | Type | Default | Description |
|---|---|---|---|
classes | array | - | Additional CSS class words merged into the root element. |
attributes | object | - | Additional HTML attributes spread on the root element. |
Classes
| Class | Capability | Default | Description |
|---|---|---|---|
.subtle | Emphasis | - | Lower emphasis; a muted, quieter weight. |
.neutral | Emphasis | Yes | Default emphasis; the standard weight at balanced contrast. |
.accent | Emphasis | - | Higher emphasis; a stronger, louder weight. |
.info | Intent | - | Informational message. |
.warning | Intent | - | Warning or caution. |
.danger | Intent | - | Error, destructive, or critical. |
.success | Intent | - | Confirmation or completion. |
.sm | Size | - | Small. |
.md | Size | Yes | Medium. |
.lg | Size | - | Large. |
.xl | Size | - | Extra large. |
Examples
Small
Compact size for narrow rails or four-up rows on small viewports.
Medium
Default size suitable for most marketing rows and dashboard summaries.
Large
Visually prominent size; pair with a wider grid cell.
Extra large
Hero-scale size for full-row callouts or two-up pairings.
Grid
Multiple facts composed via the project grid utility, with the count controlled by the items arg.
Accessibility
- WCAG 2.2 AA
- Wrapped in
<article>so each fact is independently announced - Value rendered as
<strong>for emphasis without inventing a new heading level - Supertitle and description rendered as
<small>so assistive tech treats them as supporting copy - Color is never the sole carrier of meaning - the value, label, and supertitle text always describe the fact