# Mail Client Thread List

Virtualized email thread list with unread, starred, labels, attachments and snooze markers.

- id: `mail-client-thread-list`
- Page: https://agentic-ui-kit.com/components/mail-client-thread-list
- Live preview: https://agentic-ui-kit.com/live/fixture/mail-client-inbox?piece=mail-client-thread-list&within=mail-client-inbox&mark=div.overflow-y-auto%3Ahas%28%3E+ul%5Baria-label%5D%29

## Install

```bash
agentic-ui add mail-client-thread-list
npx shadcn@4.17.0 add @agentic-ui/mail-client-thread-list
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** windowed-rows, unread-weight, star-toggle, row-checkboxes, label-chips, attachment-marker, snooze-marker, hover-quick-actions, search-highlight, comfortable-and-compact-density
- **Intents:** manage-collection, communicate
- **Suits domains:** saas, support, crm, personal-productivity
- **Interaction:** list, select, star, hover-actions, virtual-scroll
- **Screen role:** management
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** virtualized email thread list with unread, starred, labels, attachments and snooze markers, inbox list that stays fast with thousands of conversations and marks search matches
- **Avoid when:** a table with sortable columns (use the data table pieces), a chat message list
- **Preserve when adapting:** single-h1-per-page, markdown-body-parser, search-query-parser, rules-engine, link-integrity
- **Replace when adapting:** brand-copy, seed-data, assistant-functions
- **Adaptation effort:** low
- **Coupling:** medium
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** button, badge, input, label, checkbox
- **npm dependencies:** next, lucide-react, next-themes, @tanstack/react-virtual, @tiptap/react
- **Motion:** profile none, library css, reduced-motion fallback yes
- **Used in:** Mail Client (blueprint)
- **npm dependencies (registry):** @tanstack/react-virtual@^3.13.12, lucide-react@0.577.0
- **Registry dependencies:** lib-primitives