# Shop Activity block

> Shop Activity Dashboard

Inventory dashboard: 4 KPI stat tiles + inventory velocity bar chart + top categories list + tabbed shop activity table (Products / Recent activities / Orders). Composed by adapting existing application blocks (stats-1, chart-29, list-1) into a single shop-management surface.

- Type: Pro block
- Category: [Inventory](https://web.dev.reui.io/blocks/solutions/inventory.md)
- Page: https://web.dev.reui.io/blocks/solutions/inventory/solution-inventory-5
- MCP: `get_block("solution-inventory-5")`
- Built with: Badge, Button, Chart, Data Grid, Dropdown Menu, Frame, Rating, Separator, Tabs
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

Retail price over unit cost and star ratings per product, a hatched weekly units bar chart and a revenue ranked category list

## Agent notes

- `products`, `stats`, `velocityData` and `topCategories` in data.ts are sample data; `activities` and `orders` there are unused
- The Last 30 days, Export, New product and View all buttons (`DashboardHeader`, `ActivityTabs`, `TopCategories`) have no handler
- The row action menus in `ActivityTabs` and the tile menus in `Stats` have no handlers, so wire each item

## When not to use

- A retail sales overview led by revenue, stacked sales charts and an order queue: use [Retail Revenue](https://web.dev.reui.io/blocks/application/dashboard/dashboard-7.md) (`get_block("dashboard-7")`)
- Stock tracked per SKU with a Backordered status and a days of cover column: use [Inventory Dashboard](https://web.dev.reui.io/blocks/solutions/inventory/solution-inventory-1.md) (`get_block("solution-inventory-1")`)

## Third-party libraries

- Recharts v3: [API reference](https://recharts.github.io/en-US/api/), [docs](https://recharts.github.io/en-US/guide/getting-started/)
- 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)

## Install

```bash
npx shadcn@latest add @reui/solution-inventory-5
```

## About Inventory blocks

### When to use

- Stock overview and ledger pages: KPI tiles, a stock health bar and a filterable SKU table
- A low stock reorder queue, or a purchase order received line by line from its supplier
- Product and order overlays: stock rules, variants and photos, order review, tracking or a shipping label

### When not to use

- A team overview of KPI tiles and charts where nothing tracks stock or SKUs: use the [Dashboard blocks](https://web.dev.reui.io/blocks/application/dashboard.md)
- A side panel for a record other than a product, order or shipment: use the [Sheet blocks](https://web.dev.reui.io/blocks/application/sheet.md)
- An activity or event history on its own, with no stock or shipment around it: use the [Timeline blocks](https://web.dev.reui.io/blocks/application/timeline.md)

### Agent notes

- Every block sets a `min-h-svh` wrapper with its own padding in page.tsx or its root component; drop it when the block mounts inside your app layout
- No block fetches or saves anything: actions set local state, fire a sonner `toast`, link to a page anchor or have no handler, so wire each to your API

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.