Skip to main content

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 lg and xl sizes 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 xl in 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​

SlotRequiredDescription
valueYesThe headline number or short symbol (for example "14ms", "99.99%", "4.7 stars", "FSCS").
labelYesOne-line caption describing the value.
supertitle-Optional eyebrow above the value (for example "p99", "median").
description-Optional second line below the label.

Props​

PropTypeDefaultDescription
classesarray-Additional CSS class words merged into the root element.
attributesobject-Additional HTML attributes spread on the root element.

Classes​

ClassCapabilityDefaultDescription
.subtleEmphasis-Lower emphasis; a muted, quieter weight.
.neutralEmphasisYesDefault emphasis; the standard weight at balanced contrast.
.accentEmphasis-Higher emphasis; a stronger, louder weight.
.infoIntent-Informational message.
.warningIntent-Warning or caution.
.dangerIntent-Error, destructive, or critical.
.successIntent-Confirmation or completion.
.smSize-Small.
.mdSizeYesMedium.
.lgSize-Large.
.xlSize-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
  • card - richer block with media and CTAs
  • progress - in-progress measurement instead of a static value