# Account Balances block

> Account balance summary card grid with colored icon tiles and signed percent-change indicators

Multi-account balance overview: per-account cards showing balance, type label, and color-coded gain/loss delta with a colored icon tile. Built on ReUI Frame, FramePanel, and shadcn Item. For wallet, treasury, and finance 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-25
- MCP: `get_block("card-25")`
- Built with: Frame, Item
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

Account balance tiles in USD with a type label and a teal or rose change shown as percent and amount

## Agent notes

- Replace `CARDS` in data.tsx with your accounts; each `iconBg` is a fixed Tailwind color class for that tile
- `positive` is set by hand beside the `percent` and `amount` strings, so derive it from the real change to keep teal or rose in step with the sign
- The USD caption above each `balance` is a fixed string in card-item.tsx, so change it for an account held in another currency

## When not to use

- One balance followed over time with high, low and change figures above its line: use [Balance Tracker](https://web.dev.reui.io/blocks/chart/line-chart/chart-4.md) (`get_block("chart-4")`)
- Balances for many customers in rows you can search, sort and page through: use [Customer Balances](https://web.dev.reui.io/blocks/data-grid/base/data-grid-base-1.md) (`get_block("data-grid-base-1")`)

## Install

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

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