# KPI Area Charts block

> KPI metric stat grid in a bordered frame with per-cell area charts and trend badges

Dashboard KPI stat grid: bordered Frame splits into metric cells, each with an icon, large value, delta Badge, and an area chart. ReUI Frame, FramePanel, Badge. Analytics overview, stats cards, metric tiles.

- Type: Pro block
- Category: [Card](https://web.dev.reui.io/blocks/application/card.md)
- Page: https://web.dev.reui.io/blocks/application/card/card-29
- MCP: `get_block("card-29")`
- Built with: Badge, Frame
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

One bordered KPI grid split into cells, each with an icon, a two tone figure, a delta badge and a decorative indigo area wedge

## Agent notes

- `MetricAreaShape` draws fixed `METRIC_AREA_LEVELS` polygons picked by `index`, not your data, so swap in a real chart to plot a trend
- Replace `CARDS` in data.tsx; `badge` is a free delta string such as $4K, with its `variant` and `badgeIcon` picked by hand
- Cell borders in `CardItem` come from `index` and `total` and assume 4 cells, so recheck them when the count changes

## When not to use

- Metric tiles whose area shape plots real values, with a hover tooltip: use [KPI Trend Cards](https://web.dev.reui.io/blocks/chart/sparkline/chart-15.md) (`get_block("chart-15")`)
- A full revenue overview with KPI sparklines, sales trends and an order queue: use [Retail Revenue](https://web.dev.reui.io/blocks/application/dashboard/dashboard-7.md) (`get_block("dashboard-7")`)

## Install

```bash
npx shadcn@latest add @reui/card-29
```

## About Card blocks

### When to use

- Rows and grids of KPI tiles, each a value and a label with an optional trend badge or icon
- Grids of small linked cards for features, setup steps, guides, integrations or partner logos
- One record or offer per card: a profile, applicant, delivery, meeting, job, asset price or promo

### When not to use

- A metric panel with a progress bar, a segmented gauge or supporting rows under the total: use the [Stats blocks](https://web.dev.reui.io/blocks/application/stats.md)
- A KPI whose trend over time is plotted, with a period switcher or tooltips: use the [Area Chart blocks](https://web.dev.reui.io/blocks/chart/area-chart.md)
- A whole overview page: a header, a row of KPI tiles, then a work list or trend panel: use the [Dashboard blocks](https://web.dev.reui.io/blocks/application/dashboard.md)

### Agent notes

- Every block centers itself in a padded `min-h-svh` wrapper in page.tsx or its root component; remove it when the card goes inside your own page

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