# Customer Balances block

> Customer CRM data grid with avatar rows, balance trends, and row actions menu

Customer table for CRM and admin dashboards: search, status filter, avatar rows, balance trend tooltips, sortable resizable columns, pagination, and a row actions menu with delete confirm. ReUI DataGrid, Frame, Badge plus shadcn Avatar, DropdownMenu.

- Type: Pro block
- Category: [Base](https://web.dev.reui.io/blocks/data-grid/base.md)
- Page: https://web.dev.reui.io/blocks/data-grid/base/data-grid-base-1
- Docs (Base UI): https://web.dev.reui.io/docs/components/base/data-grid.md
- Docs (Radix UI): https://web.dev.reui.io/docs/components/radix/data-grid.md
- MCP: `get_block("data-grid-base-1")`
- Built with: Alert Dialog, Avatar, Badge, Button, Checkbox, Data Grid, Dropdown Menu, Frame, Input Group, Item, Label, Popover, Separator, Tooltip
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

Customer balances with a reversal tooltip for refunds and chargebacks and a trend percent against the prior statement period

## Agent notes

- Replace `EMPLOYEES`; `balanceMeta` feeds the balance cell, yet `rowShowsBalanceHint` shows the trend tooltip only for numeric ids ending in 3 or 8
- `ActionsCell` View Details, Edit and Delete only toast, and `setEmployees` is never called, so a confirmed delete keeps the row
- Export CSV, Refresh and View settings in `Toolbar`, plus the Add customer button, only fire toasts

## When not to use

- Density and column visibility set from a settings popover: use [Course Catalog](https://web.dev.reui.io/blocks/data-grid/columns/data-grid-columns-2.md) (`get_block("data-grid-columns-2")`)

## Third-party libraries

- TanStack Table v9: [API reference](https://tanstack.com/table/v9/docs/framework/react/reference/index), [docs](https://tanstack.com/table/v9/docs/framework/react/quick-start)
- Sonner v2: [API reference](https://sonner.emilkowal.ski/toast), [docs](https://sonner.emilkowal.ski/getting-started)

## Install

```bash
npx shadcn@latest add @reui/data-grid-base-1
```

## About Base blocks

### When to use

- A whole table section: a title, a create button, filter controls, the rows and pagination
- Customer, contact and deal tables for a sales team, with a row menu, pinned rows or a rule filter bar
- Operations tables for support tickets, weekly timesheets, team members, project modules or SKU prices

### When not to use

- A bare table for your own columns and rows, without a title bar, toolbar or demo rows: use [Data Grid](https://web.dev.reui.io/components/data-grid.md) (`get_component("data-grid")`)
- Thousands of rows in one scrolling list that loads more as the reader nears the end: use the [Virtualization blocks](https://web.dev.reui.io/blocks/data-grid/virtualization.md)
- A payments ledger, a renewals queue or an automation library led by a rule filter bar: use the [Filtering blocks](https://web.dev.reui.io/blocks/data-grid/filtering.md)

### Agent notes

- Each page.tsx wraps the table in a centered `min-h-svh` main under an sr-only `h1`; drop that wrapper and keep a single `h1` once it sits in your page
- Each block filters and pages its data.tsx rows in the browser with `pagination` in local state; move both to your API before the row count grows large

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.