---
title: "Empty states"
description: "Standardizes the anatomy (icon, title, description, action) for UI shown when there is no data — first-run, zero search results, deleted content, or error…"
category: "App Shell & Navigation"
---

# Empty states

> Generated from `mcp/patterns.registry.json` — do not edit by hand; change the registry and run `bun run patterns:build`.

_Index card — the docs below are the canonical explanation; deep-tier pattern pages additionally carry invariants and emulation notes._

**Category:** App Shell & Navigation · **Tier:** light · **Risk:** low — structural pattern, no external services

Standardizes the anatomy (icon, title, description, action) for UI shown when there is no data — first-run, zero search results, deleted content, or error recovery.

**When to use:** Reach for it when a list, search, or page has no data to render and needs a first-run or zero-result affordance instead of a blank screen.

## Docs

- [docs/blueprint/app-shell/empty-states.md](/docs/blueprint/app-shell/empty-states) ([GitHub](https://github.com/ApeDevil/v10r/blob/main/docs/blueprint/app-shell/empty-states.md) · [GitLab](https://gitlab.com/ApeDevil/v10r/-/blob/main/docs/blueprint/app-shell/empty-states.md))

## Code

- `src/lib/components/composites/empty-state/` ([GitHub](https://github.com/ApeDevil/v10r/tree/main/src/lib/components/composites/empty-state) · [GitLab](https://gitlab.com/ApeDevil/v10r/-/tree/main/src/lib/components/composites/empty-state))

---

_Machine-readable record: `app-shell-empty-states` in `mcp/patterns.registry.json`._