Empty states
Generated from
mcp/patterns.registry.json— do not edit by hand; change the registry and runbun 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
Code
Machine-readable record: app-shell-empty-states in mcp/patterns.registry.json.