# Top Movers block

> Top movers list table with company logos, status badges, and up/down trend values

Top movers leaderboard table: company rows with logo and location, status badges (Active, New, On Hold), and a trend column with gain/loss value and up/down arrow. Header search with Cmd-K hint. ReUI Frame, Badge, shadcn Table, InputGroup, Kbd.

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

## Best for

A movers table pairing each company and location with an Active, New or On Hold badge and an arrowed gain or loss

## Agent notes

- Replace `topMovers`; `status` sets the badge, `trend` sets the arrow and color, and `activeValue` is a preformatted string
- `logoBgClassName` is set on every mover but `TopMovers` never reads it, so give each `logo` its own tile background
- The search in `TopMovers` is an uncontrolled `InputGroupInput` with a `Kbd` hint, so filtering and the shortcut are yours to add

## When not to use

- A headerless stack of KPI rows, each with an icon tile and a trend badge: use [Order KPI List](https://web.dev.reui.io/blocks/application/list/list-1.md) (`get_block("list-1")`)
- Company rows with a sector column and the date under each name, no status badges: use [Recent Investments](https://web.dev.reui.io/blocks/application/list/list-10.md) (`get_block("list-10")`)

## Install

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

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