# AI Chat Empty State

Assistant chat with no messages that offers four starting points configured by the workspace.

- id: `ai-chat-empty-state`
- Page: https://agentic-ui-kit.com/components/ai-chat-empty-state
- Live preview: https://agentic-ui-kit.com/live/component/ai-chat-empty-state

## Install

```bash
agentic-ui add ai-chat-empty-state
npx shadcn@4.17.0 add @agentic-ui/ai-chat-empty-state
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** prompt-suggestions, customisable-suggestion-set, templated-prompt-variables, variable-fill-form, resolved-prompt-preview, category-filtering, suggestion-search, roving-keyboard-navigation, compact-layout, loading-state, empty-state, error-recovery
- **Intents:** converse, navigate, generate-content
- **Suits domains:** ai-workspace, knowledge, saas, support, devtools
- **Interaction:** select-suggestion, fill-template-variables, filter-by-category, search-suggestions, keyboard-navigation, retry-after-error
- **Screen role:** communication
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** assistant chat with no messages that offers four starting points configured by the workspace, side help panel with three quick prompts about the open project, support assistant whose team configures templates with product and customer variables, developer console that starts with diff review and test plan prompts
- **Avoid when:** the conversation already has messages: the empty state disappears as soon as there is history, product with no configurable prompts where a static welcome text is enough
- **Preserve when adapting:** suggestions-as-data, variable-resolution-before-submit, roving-focus-model, filter-and-search-composition
- **Replace when adapting:** suggestion-copy, category-taxonomy, hero-copy, suggestion-icons
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** badge, button, card, input
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Registry dependencies:** lib-primitives