Metric Card

A KPI tile — label, big value and a percent delta whose sign picks the trend colour and glyph.

tsx
import { MetricCard } from "@pestoui/core"

Deltas

A positive delta reads success, a negative one reads destructive, and zero stays muted.

Conversations

12,480

Trending up, +12.4%vs last week

Failed runs

37

Trending down, -8.1%vs last week

Active agents

24

No change, 0%vs last week

With a leading icon

Pass any node to icon and it renders inside a soft squircle IconTile beside the label.

Team seats

18

Trending up, +5.2%

Messages handled

9,102

Trending up, +21%

Avg. response

1.8s

Trending down, -14.3%

Centred

align="center" stacks the icon over the label — use it for a short row of headline numbers.

Runs today

1,204

Trending up, +3.6%

New workspaces

86

Trending down, -2.4%

Props

PropTypeDefaultDescription
labelReactNode—What the number measures.
valuestring | number—The headline figure.
deltanumber—Percent change. Its sign picks the trend colour and glyph; omit it to hide the delta row.
deltaLabelReactNode—Muted text beside the delta, e.g. “vs last week”.
iconReactNode—Rendered inside a leading soft IconTile.
chartReactNode—Slot for a sparkline or small chart, shown in a second card row.
align"start" | "center""start"Text and icon alignment inside the card.

Pesto UI · 117 documented components