Site color

Choose your site’s color palette.

Saved on this device.

MetricStrip

MetricStripEvidence at a glance

Arrange related metrics in a responsive surface with a clear reading order.

Landing & pricing

A 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.

A workspace at a glanceCOMPOSITION

Pages

24

Published in this workspace.

Contributors

128

People building together.

Build time

1.8 s

Latest local preview.

Checks passed

8/8

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.

Progress and the next milestoneCOMPOSITION

Completed tasks

8 of 10

Two final details to review in this example.

Next milestone

Review

Bring the team together for the finishing touches.

View guides

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.

All ten semantic tonesCOMPOSITION

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.

All eighteen visual variantsCOMPOSITION

Switch the site theme to compare the same samples in both palettes.

Responsive density

Two, three, or four signalsCOMPOSITION
2 metrics

Components

48

Guides

13
3 metrics

Components

48

Guides

13

Themes

2
4 metrics

Components

48

Guides

13

Themes

2

Workspaces

6

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.