# CRM Contacts Directory List

Container of switchable contact cards.

- id: `crm-contacts-directory-list`
- Page: https://agentic-ui-kit.com/components/crm-contacts-directory-list
- Live preview: https://agentic-ui-kit.com/live/piece/crm-contacts-directory-list?piece=crm-contacts-directory-list

## Install

```bash
agentic-ui add crm-contacts-directory-list
npx shadcn@4.17.0 add @agentic-ui/crm-contacts-directory-list
```

## Metadata

- **Level:** block
- **Category:** block
- **Template:** Rolodeck CRM
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** grid-view, list-view, empty-state, filtered-contacts-rendering
- **Intents:** manage-collection, explore-detail
- **Suits domains:** crm, saas, hr, personal-productivity
- **Interaction:** selection, scroll, view-mode-rendering
- **Screen role:** management
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** Container of switchable contact cards, Dynamic listing that handles the empty state and filters
- **Avoid when:** The dataset exceeds thousands of records without virtualized pagination
- **Preserve when adapting:** dual-view-logic, empty-state-handling
- **Replace when adapting:** card-component, mock-data
- **Adaptation effort:** medium
- **Coupling:** medium
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 7/10, code 8/10
- **Uses primitives:** avatar, badge, button, dropdown-menu
- **npm dependencies:** zustand, lucide-react
- **Used in:** Rolodeck CRM (template), Marketing Analytics (blueprint)
- **npm dependencies (registry):** date-fns@4.1.0, lucide-react@0.577.0, zustand@5.0.8
- **Registry dependencies:** crm-contacts-contact-card, lib-utils