AgentEmptyState
Empty-state panel with a clear next action. Import from @agent-ui/react or a direct subpath. Tailwind CSS v4 theme tokens are required.
AgentEmptyState ships with a full API table, a copyable example, and accessibility notes.
Nothing here yet
Start a conversation to see messages.
Installation
Install the package once, then import AgentEmptyState from its direct entry point or from the root.
pnpm add @agent-ui/reactimport { AgentEmptyState } from "@agent-ui/react/blocks/empty-state";Tailwind CSS v4 users: add @source "../node_modules/@agent-ui/react/src" to the global stylesheet so the library utilities are generated.
Usage
The example below is the same code that renders the preview. Copy it, swap in your own handlers, and ship.
import { AgentEmptyState } from "@agent-ui/react"; <AgentEmptyState title="No messages" description="Start a conversation." />API reference
Every prop AgentEmptyState accepts, its type, default, and behaviour.
| Name | Type | Default | Description |
|---|---|---|---|
| title | React prop | — | Configuration exposed through the component's public React props. |
| description | React prop | — | Configuration exposed through the component's public React props. |
| action | React prop | — | Configuration exposed through the component's public React props. |
| icon | React prop | — | Configuration exposed through the component's public React props. |
Accessibility
AgentEmptyState composes with MessageList, ChatShell, useChat, and the provider compose blocks. Browse the full reference or see all components in the gallery.
3 lines · copy-ready