# Shadcn List blocks

> List layouts for contacts, records, activity rows, grouped collections, and compact action surfaces.

- Type: Pro blocks (Application)
- Page: https://web.dev.reui.io/blocks/application/list
- Blocks: 11
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

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

## Blocks

- [Order KPI List](https://web.dev.reui.io/blocks/application/list/list-1.md): Order Metrics List Card with Icon Tiles and Up Down Trend Badges. Best for a headerless stack of 4 KPI rows, each with an icon tile, a trend badge and an open details arrow button.
- [Fund Leaderboard](https://web.dev.reui.io/blocks/application/list/list-2.md): Capital inflows fund leaderboard list with logo badges and a range filter select. Best for a fund leaderboard with a Capital In amount per row and a Select that cuts it to the top 3, the top 5 or all 6.
- [Capital Inflows](https://web.dev.reui.io/blocks/application/list/list-3.md): Capital Inflows Card with Period Tabs and Ranked Fund List Showing Amount and Share. Best for a percent share next to each fund amount, with Weekly and All Time tabs and an info tooltip on the title.
- [Crypto Portfolio](https://web.dev.reui.io/blocks/application/list/list-4.md): Crypto Portfolio Snapshot List with Period Tabs and Per-Asset Trend Badges. Best for coin holdings with a unit price, a trend badge, a fiat value and a token balance per row, over an Add Asset button.
- [Crypto Activity Feed](https://web.dev.reui.io/blocks/application/list/list-5.md): Crypto Transactions List with Color-Coded Credit and Debit Amounts. Best for a bare 5 row crypto feed with no header or footer, where an arrow tile tinted green or red marks credit or debit.
- [Wallet Transfers](https://web.dev.reui.io/blocks/application/list/list-6.md): Crypto transaction list card with period tabs and dual-token swap amounts. Best for on chain transfers with token logos, From or To wallet addresses, a Failed title in red and 2 amounts on each swap.
- [Spending Feed](https://web.dev.reui.io/blocks/application/list/list-7.md): Wallet Transactions List with Period Tabs and Color-Coded Category Icons. Best for a spending feed with colored category icons for deposits, groceries, bills, dining and interest, above View More.
- [Integrations Directory](https://web.dev.reui.io/blocks/application/list/list-8.md): Integrations directory list with brand logos and per-row Connect buttons. Best for third party app logos with a short purpose line and a Connect button on each row, over a See All footer.
- [Capability Modules](https://web.dev.reui.io/blocks/application/list/list-9.md): Manual integrations picker list with icon tiles, per-row add buttons, and Browse More footer. Best for capability modules such as anomaly detection and fraud monitoring, each in a muted icon tile with a plus button.
- [Recent Investments](https://web.dev.reui.io/blocks/application/list/list-10.md): Recent Investments Card with Searchable Gain-Loss Table and Company Logos. Best for a fixed layout investments table with the date under each company name and a signed green or red value change.
- [Top Movers](https://web.dev.reui.io/blocks/application/list/list-11.md): Top movers list table with company logos, status badges, and up/down trend values. Best for a movers table pairing each company and location with an Active, New or On Hold badge and an arrowed gain or loss.

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.
