# Shadcn User Follow

> User item with avatar, info, and follow button

- Type: example, free and open source (MIT)
- Component: [Item](https://reui.io/components/item.md)
- Page: https://reui.io/components/item/c-item-3
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/item.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/item.md
- MCP: `get_example("c-item-3")`
- Registry item: https://reui.io/r/styles/base-nova/c-item-3.json
- Uses: Avatar, Button, Item

## Best for

Compact people rows with a photo and job title that show the follow button in both states, Follow and Following

## Agent notes

- Follow and Following are 2 fixed `Button` variants with no state; keep a following flag per person to swap label and variant

## When not to use

- A feed of who did what and when, one person per row with a timestamp: use [Activity Feed](https://reui.io/components/item/c-item-12.md) (`get_example("c-item-12")`)

## Install

```bash
npx shadcn@latest add @reui/c-item-3
```

## About Shadcn Item

### When to use

- Rows of people, files, services or events, each an avatar or icon beside text, a badge or a button
- Clickable menus of account pages, mailbox folders or commands, ending in a chevron, count or key
- A compact record card with a header and footer, such as a project with status, team and progress

### When not to use

- A finished dashboard panel of KPIs, transactions or integrations with data on every row: use the [List blocks](https://reui.io/blocks/application/list.md)
- A whole page of account options in labeled rows, each with its own switch, select or input: use the [Settings blocks](https://reui.io/blocks/application/settings.md)
- Rows the user reorders by dragging them up or down the page: use [Sortable](https://reui.io/components/sortable.md) (`get_component("sortable")`)

### Agent notes

- Make a row a link through `render` on the base twin or `asChild` on radix; every style draws the hover fill only when the row is an anchor
- `ItemGroup` sets `role` list but `Item` sets no listitem role, so wrap each row in an element that carries it
- `ItemTitle` clamps to 1 line and `ItemDescription` to 2, so longer text is cut off until a `className` lifts the clamp

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.
