# Portfolio Allocation block

> Portfolio allocation cards for 3 asset sleeves with period tabs, delta badges and segmented meters

Equities, fixed income and alternatives cards, each on its own 1W, 1M, 3M and 1Y tabs with an allocation share, a signed delta, a 40 bar meter, exposure and managers. ReUI Frame, Badge; shadcn Tabs, Tooltip, Avatar. Asset management, fund dashboards.

- Type: Pro block
- Category: [Stats](https://reui.io/blocks/application/stats.md)
- Page: https://reui.io/blocks/application/stats/stats-17
- MCP: `get_block("stats-17")`
- Built with: Avatar, Badge, Button, Frame, Tabs, Tooltip
- Installs with a ReUI Pro or Ultimate license; setup: https://reui.io/docs/license-setup

## Best for

Sleeve cards that each keep their own reporting period, pairing a share meter with dollar exposure and a manager avatar stack

## Agent notes

- Replace `SLEEVES` in data.ts; each period in `snapshots` holds `allocation`, `delta` and `exposure`, and the meter fill derives from `allocation`
- `managerCount` is typed apart from the `managers` avatars, so the Managers label can disagree with the stack; tie it to your roster
- Each card mounts its own uncontrolled `Tabs` at `DEFAULT_PERIOD`, so a period switch on one card leaves the others as they were

## When not to use

- Capacity figures as a share of a total in one divided panel, each over a segmented meter: use [Capacity Usage](https://reui.io/blocks/application/stats/stats-18.md) (`get_block("stats-18")`)
- One total split across funds on a single donut, each amount and percent in a legend: use [Inflows by Source](https://reui.io/blocks/chart/pie-chart/chart-13.md) (`get_block("chart-13")`)

## Install

```bash
npx shadcn@latest add @reui/stats-17
```

## About Stats blocks

### When to use

- A row of 3 or 4 KPI tiles to sit above the content of a page you already have
- One metric card that pairs a headline figure with a meter, a split bar or supporting rows
- A card already written for one topic: leads, tasks, quota, compliance, renewals, adoption, balance or capacity

### When not to use

- Tiles on a dotted, halftone or line grid backdrop, or records such as profiles or jobs: use the [Card blocks](https://reui.io/blocks/application/card.md)
- A metric whose value carries a small trend drawn beside or under it: use the [Sparkline blocks](https://reui.io/blocks/chart/sparkline.md)
- A whole overview page with a header, summary tiles and a work list or trend under them: use the [Dashboard blocks](https://reui.io/blocks/application/dashboard.md)

### Agent notes

- Each page.tsx only centers `Stats` in a padded wrapper; mount `Stats` from components/stats.tsx inside your own layout
- `Stats` takes no props, fetches nothing and wires no handler, so add props for your own figures and callbacks

Every ReUI item has a twin like this one; the index is https://reui.io/llms.txt. Agents with the ReUI MCP (https://reui.io/docs/mcp) get the same guidance from the getters named above.