# Order KPI List block

> Order Metrics List Card with Icon Tiles and Up Down Trend Badges

Compact KPI metric list: framed icon tile, large value, colored up/down trend badge, and open-details button per divided row. ReUI Frame, Badge, shadcn Item, Button, Separator. Stats summary, dashboard, finance overview.

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

## Best for

A headerless stack of 4 KPI rows, each with an icon tile, a trend badge and an open details arrow button

## Agent notes

- Replace the 4 `orderMetrics` in data.tsx; `value`, `suffix` and `trend` are display strings, and `trendDirection` alone picks the green or red `Badge`
- The arrow `Button` in each `MetricRow` has no click handler or link; wire it to the detail view of that metric

## When not to use

- Metric cards set side by side in up to 3 columns, each with a reporting date range: use [Analytics Overview](https://web.dev.reui.io/blocks/application/stats/stats-8.md) (`get_block("stats-8")`)
- A table of companies under a search field, each with a status badge and a gain or loss: use [Top Movers](https://web.dev.reui.io/blocks/application/list/list-11.md) (`get_block("list-11")`)

## Install

```bash
npx shadcn@latest add @reui/list-1
```

## About List blocks

### When to use

- A dashboard side panel of KPIs, funds, coins, investments or movers with a figure on every row
- A short wallet or crypto transaction history with a signed credit or debit amount on each row
- An integrations directory or picker with a connect or add button on every row

### When not to use

- Records or metrics laid out as separate tiles in a grid, one tile per record: use the [Card blocks](https://web.dev.reui.io/blocks/application/card.md)
- A single row layout of media, title and actions to compose a list of your own: use [Item](https://web.dev.reui.io/components/item.md) (`get_component("item")`)
- Headline metrics that each need an actions menu, a progress bar or a segmented gauge: use the [Stats blocks](https://web.dev.reui.io/blocks/application/stats.md)

### Agent notes

- Each page.tsx centers the block in a padded `min-h-svh` wrapper; drop it when the list goes into your own dashboard layout
- Every root component takes no props and renders constants from its `data` module; add props to pass in your own rows
- Every `FramePanel` pins its padding with an important utility, so changing the Frame `spacing` prop leaves those insets as they are

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.