MetricStrip
MetricStripEvidence at a glance Arrange related metrics in a responsive surface with a clear reading order.
Landing & pricingA workspace snapshot
MetricStrip brings related MetricItems together on one surface, with generous spacing and a consistent reading order. Use it to introduce a product's key numbers or give a quick view of a project's progress.
The default layout moves from one column on narrow screens to two at sm and four at lg. These illustrative values show a complete workspace snapshot.
Pages
Published in this workspace.
Contributors
People building together.
Build time
Latest local preview.
Checks passed
Ready for the next step.
Four related signals, one shared surface. All values describe an example workspace.
<MetricStrip tone="neutral">
<MetricItem
label="Pages"
value="24"
detail="Published in this workspace."
icon="lucide:globe"
tone="accent"/>
<MetricItem
label="Contributors"
value="128"
detail="People building together."
icon="lucide:users"
tone="info"/>
<MetricItem
label="Build time"
value="1.8 s"
detail="Latest local preview."
icon="lucide:clock"
tone="secondary"/>
<MetricItem
label="Checks passed"
value="8/8"
detail="Ready for the next step."
icon="lucide:circle-check"
tone="success"/>
</MetricStrip> A two-metric summary
Set columnsLg="2" to keep two columns on larger screens. A metric can include a short status instead of a number, and its default slot can provide a next step.
Completed tasks
Two final details to review in this example.
A focused two-column summary, with supporting context and a useful destination.
<MetricStrip tone="accent" variant="surface" columnsSm="2" columnsLg="2">
<MetricItem
label="Completed tasks"
value="8 of 10"
detail="Two final details to review in this example."
icon="lucide:circle-check"
tone="accent"/>
<MetricItem
label="Next milestone"
value="Review"
detail="Bring the team together for the finishing touches."
icon="lucide:users"
tone="accent"
>
<BtnLink
href="/guides/"
tone="accent"
variant="link"
icon="lucide:arrow-right"
iconPosition="end"
>
View guides
</BtnLink>
</MetricItem>
</MetricStrip> All ten semantic tones
The same composition in every semantic tone. Child tones are explicit where the composition owns them, including navigation actions.
neutral Components
One shared design language
accent Components
One shared design language
feature Components
One shared design language
secondary Components
One shared design language
custom Components
One shared design language
ghost Components
One shared design language
info Components
One shared design language
success Components
One shared design language
warning Components
One shared design language
danger Components
One shared design language
Switch the site theme to compare the same samples in both palettes.
All eighteen visual variants
Every supported variant is shown in accent, including none. Variant controls the outer treatment; nested content may use its own treatment.
solid surface Components
One shared design language
surfaceAlt Components
One shared design language
spotlight Components
One shared design language
glass Components
One shared design language
flat Components
One shared design language
flatAlt Components
One shared design language
flatSolid outlineFill outline Components
One shared design language
subtle Components
One shared design language
subtleBtn Components
One shared design language
link Components
One shared design language
sheen underline Components
One shared design language
rail bracket Components
One shared design language
none Components
One shared design language
Switch the site theme to compare the same samples in both palettes.
Responsive density
2 metricsComponents
Guides
3 metricsComponents
Guides
Themes
4 metricsComponents
Guides
Themes
Workspaces
columns is the base count; columnsSm and columnsLg replace it at their breakpoints. Child MetricItem tones are explicit.
Feature map
| Public feature | Visible example |
|---|---|
| tone, variant | Complete galleries above, with all supported values visible together. |
| columns, columnsSm, columnsLg | Two-, three-, and four-metric examples each start with one column and change at the small and large breakpoints. Resize to compare. |
| Default slot | MetricItem supplies the usual child; the strip can group other content too. Child tones are explicit. |
| Native attributes and events | Pass attributes through the root; keyboard behavior belongs to the composed native controls. |
This component exposes tone and variant, but no variantMode. Style individual child components explicitly when their appearance should match.
Behavior and accessibility
Use short labels and include units, time periods, and sources in the details. The label, value, and detail inherit the strip's text color; each MetricItem's tone colors its icon. MetricStrip groups content and does not calculate values.
The strip uses Panel, Grid, and built-in spacing utilities, with no additional component stylesheet. Use its metric-strip class for any site-specific styling.
API reference
MetricStrip contract
Props below are the public template API. RefOrValue accepts a literal or a reactive ref; bind refs with a colon-prefixed attribute. Native attributes and events can be passed through the component root.
tone
RefOrValue<SemanticTone> - Default
inherited
Semantic intent: neutral, accent, secondary, info, success, warning, danger, feature, custom or ghost. The active skin supplies the colors.
variant
RefOrValue<ComponentVariant> - Default
surface
Visual treatment. Accepts solid, surface, surfaceAlt, spotlight, glass, flat, flatAlt, flatSolid, outlineFill, outline, subtle, subtleBtn, link, sheen, underline, rail, bracket or none.
columns
RefOrValue<number | string> - Default
1
Column count from 1 to 12, or a CSS track list such as minmax(0, 1fr) auto. Numeric counts are clamped.
columnsSm
RefOrValue<number | string> - Default
2
Column count or CSS track list at the theme’s sm breakpoint and above.
columnsLg
RefOrValue<number | string> - Default
4
Column count or CSS track list at the theme’s lg breakpoint and above.
Composition
Default slot: MetricItem elements or other grid items. Register defineMetricStripComponent with Panel and Grid; register MetricItem separately.