# Shadcn Empty State blocks

> Empty state screens and no-data placeholders with recovery actions, onboarding prompts, and contextual guidance.

- Type: Pro blocks (Application)
- Page: https://web.dev.reui.io/blocks/application/empty-state
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/empty.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/empty.md
- Blocks: 14
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## When to use

- A first run screen for records, projects, reports or a library that holds nothing yet
- A search with zero matches or an export page that has nothing to download yet
- A setup prompt to invite the team, enable a feature or connect file storage

## When not to use

- A compact no data message placed inside a table, list or panel you already have: use [Empty](https://web.dev.reui.io/components/empty.md) (`get_component("empty")`)
- Only the layered isometric illustration, with no title, copy or actions: use [Icon Stack](https://web.dev.reui.io/components/icon-stack.md) (`get_component("icon-stack")`)
- A populated tile that shows stats, a profile, links or an integration: use the [Card blocks](https://web.dev.reui.io/blocks/application/card.md)

## Agent notes

- `EmptyState` takes no props in every block, so its copy, media and actions are fixed in the block files; add props to reuse it
- Every page.tsx centers `EmptyState` in a `min-h-svh` wrapper with padding; drop that wrapper inside your own layout
- No action is wired: buttons have no `onClick` or only fire a sonner `toast`, and every `href` is a hash anchor

## Third-party libraries

- Sonner v2: [API reference](https://sonner.emilkowal.ski/toast), [docs](https://sonner.emilkowal.ski/getting-started), used by 1 of 14 blocks

## Blocks

- [Data Import Start](https://web.dev.reui.io/blocks/application/empty-state/empty-state-1.md): Records empty state with stacked-cards illustration, dual primary actions, and quick-guide link rows. Best for a data import first run offering a live source or a CSV upload, with 2 help guide links underneath.
- [No Search Results](https://web.dev.reui.io/blocks/application/empty-state/empty-state-2.md): Search no-results empty state with suggestion chips and a stacked result-card illustration. Best for a zero match search with 3 pill suggestion chips and a grouped pair of browse and refine buttons.
- [First Project](https://web.dev.reui.io/blocks/application/empty-state/empty-state-3.md): Projects empty state with hero illustration, dual actions, and quick-start template list. Best for a first project prompt with a stepped isometric cube drawing and 2 shortcut links for a task board and sprint tracker.
- [Reports Workspace](https://web.dev.reui.io/blocks/application/empty-state/empty-state-4.md): Two-column reports empty state with icon, dual actions, and preview screenshot slot. Best for a Card split in 2 columns for an empty reports area, Add report and View sample beside a blank screenshot slot.
- [Empty Report Brief](https://web.dev.reui.io/blocks/application/empty-state/empty-state-5.md): Two-column empty state in a ReUI Frame with icon, dual actions, and a preview panel. Best for a Frame split layout for an unwritten review brief, with Draft Brief and Browse Signals next to an empty preview panel.
- [Team Launch Steps](https://web.dev.reui.io/blocks/application/empty-state/empty-state-6.md): Team workspace onboarding empty state with two action buttons and three colored setup-step tiles. Best for a team workspace launch with no header art, 2 full width outline buttons and 3 tinted next step links.
- [Invite First Member](https://web.dev.reui.io/blocks/application/empty-state/empty-state-7.md): Workspace member invite empty state with circular icon and dual invite and copy-link buttons. Best for a first invite prompt around one glyph in a bordered circle, with Invite members and Copy invite link.
- [Settings Setup Tabs](https://web.dev.reui.io/blocks/application/empty-state/empty-state-8.md): Project settings empty state with line tabs and per-section setup prompts. Best for a settings page whose 2 line tabs each hold a left aligned setup prompt with an Enable button.
- [Invite Members Prompt](https://web.dev.reui.io/blocks/application/empty-state/empty-state-9.md): Workspace member invite empty state with layered 3D icon-stack illustration and dual invite actions. Best for a workspace invite prompt with a layered IconStack glyph and a large title over Invite members and Copy invite link.
- [Blueprint Library](https://web.dev.reui.io/blocks/application/empty-state/empty-state-10.md): Card-wrapped empty state with section heading and horizontal media-beside-text layout. Best for a small Card under a library heading, its IconStack beside the copy from md up, with a create and a secondary import button.
- [Section Add Prompt](https://web.dev.reui.io/blocks/application/empty-state/empty-state-11.md): Section-header empty state with action button above a muted card and stacked icon illustration. Best for a section header that carries the one Add signal button, above a muted Card whose IconStack prompt holds no buttons.
- [Export Filters](https://web.dev.reui.io/blocks/application/empty-state/empty-state-12.md): Activity exports empty state with audience, workspace, and date-range filter toolbar. Best for an export page with 3 radio menu filters held in state and a split Execute button for CSV, PDF or scheduled delivery.
- [Cloud Storage Connect](https://web.dev.reui.io/blocks/application/empty-state/empty-state-13.md): File sources empty state with cloud storage connector grid (Dropbox, R2, Drive, OneDrive). Best for a file queue waiting on a storage link, with 4 brand logo connector tiles in a Frame and a connector guide link.
- [Enable Organizations](https://web.dev.reui.io/blocks/application/empty-state/empty-state-14.md): Organizations setup empty state with framed enable card, building icon, and tooltip help link. Best for a one feature opt in inside a Frame, with a single Enable organizations button and a footer help link that shows a tooltip.

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.