# KPI Report Links block

> Colorful dark KPI stat cards with trend badge, grid-mesh background, and footer report link

Grid of dark metric cards on colored panels, each with a big value, an up-trend Badge with percent, an icon tile, and a footer report link. Built with ReUI Frame and Badge plus shadcn Item for KPI, stats, and analytics dashboards.

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

## Best for

Fixed width tiles on saturated color panels, each a big figure, a trend badge and a full report footer link

## Agent notes

- Replace `CARDS` in data.tsx; keep each `panelClassName` and `iconClassName` on one hue so a tile reads as one color
- The trend `Badge` always draws an up arrow in emerald, so add a down state before showing a falling `trendPercent`
- The figure anchor and every `footerHref` point at #, so link both to the report each tile summarizes

## When not to use

- Color block KPI tiles whose change can fall as well as rise, with a per tile menu: use [KPI Scorecard](https://web.dev.reui.io/blocks/application/stats/stats-2.md) (`get_block("stats-2")`)
- Metric tiles on a neutral surface with an Edit, Copy link and Delete menu: use [Logistics KPI Tiles](https://web.dev.reui.io/blocks/application/card/card-30.md) (`get_block("card-30")`)

## Install

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

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