# KPI Trend Cards block

> Three KPI stat cards with gradient sparkline area charts and hover tooltips

Responsive row of metric cards, each pairing an icon, label, period and big value with a compact gradient area sparkline and hover tooltip. ReUI Frame, Recharts AreaChart. KPI dashboard, revenue and user stats overview.

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

## Best for

A set of 3 standalone ghost panels, each with a colored icon, a 28 day value and its own hued gradient area sparkline

## Agent notes

- Each `value` in `businessCards` is a typed string such as 6.238$, not read from `revenueData`, `customersData` or `activeUsersData`
- `formatValue` in the tooltip picks the currency format by matching the Revenue `title`, so renaming that card drops the currency

## When not to use

- Support figures where each tile ends in a status badge, with no trend line: use [Support Metrics](https://reui.io/blocks/application/stats/stats-12.md) (`get_block("stats-12")`)
- A revenue overview page with stacked sales plots and an order queue below its tiles: use [Retail Revenue](https://reui.io/blocks/application/dashboard/dashboard-7.md) (`get_block("dashboard-7")`)

## Install

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

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