Empty states
Generated from
pattern-library/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 · Maturity: proven (verified 2026-08-20 @ 1a130d67) · 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
Proof
/showcases/ui/components/composites— EmptyState in the feedback section
Machine-readable record: app-shell-empty-states in pattern-library/registry.json.