# KPI Strip block

> Four-column KPI stat row with corner line sparklines and trend badges

Bordered row of compact KPI stat cards, each pairing a big value with a top-right line sparkline (hover tooltip) and an up/down trend badge. Built with ReUI Frame and Badge plus shadcn Chart over Recharts. For dashboard metric strips and analytics.

- Type: Pro block
- Category: [Sparkline](https://reui.io/blocks/chart/sparkline.md)
- Page: https://reui.io/blocks/chart/sparkline/chart-2
- MCP: `get_block("chart-2")`
- Built with: Badge, Frame
- Installs with a ReUI Pro or Ultimate license; setup: https://reui.io/docs/license-setup

## Best for

A static 4 cell strip whose values split into bold and faint parts, with a hover sparkline pinned to each cell's corner

## Agent notes

- Replace `METRIC_CARDS` in data.tsx; `valueBold` and `valueFaint` are typed by hand, so the headline never reads from the card's `data` series
- Each card's `formatValue` sets its tooltip text, and `formatCurrency` appends a k, so pass spend and balance points in thousands
- Columns follow the `@container` wrapper width while cell borders switch at the viewport `md` breakpoint, so a narrow slot on a wide screen shows stray borders

## When not to use

- The same KPIs stacked as rows, each ending in an open details arrow button: use [Order KPI List](https://reui.io/blocks/application/list/list-1.md) (`get_block("list-1")`)
- Tiles led by an icon tile and a trend badge, closing on a date range with no plotted trend: use [Analytics Overview](https://reui.io/blocks/application/stats/stats-8.md) (`get_block("stats-8")`)

## Install

```bash
npx shadcn@latest add @reui/chart-2
```

## About Sparkline blocks

### When to use

- Rows of metric tiles, each pairing its value with a sparkline, a meter or a delta
- Health strips for cron jobs, SLOs or data syncs that open with KPI tiles and mini trends
- Metric lists where every row ends in a small trend and a change badge

### When not to use

- Plain KPI numbers that need only a delta badge, an actions menu or a progress bar: use the [Stats blocks](https://reui.io/blocks/application/stats.md)
- One metric that deserves a full width plot with axes and a tooltip: use the [Area Chart blocks](https://reui.io/blocks/chart/area-chart.md)
- A whole overview page that sets a header, summary tiles and a work list around its plots: use the [Dashboard blocks](https://reui.io/blocks/application/dashboard.md)

### Agent notes

- `Chart` takes no props and fetches nothing: every tile value and series comes from constants in the block's own folder

Every ReUI item has a twin like this one; the index is https://reui.io/llms.txt. Agents with the ReUI MCP (https://reui.io/docs/mcp) get the same guidance from the getters named above.