When to use
Use when a list, canvas, or inbox has nothing to show yet — or nothing matches.
Find components, patterns, tokens, and docs
Pattern
First-run or filtered-out view that explains what belongs here and how to start.
Preview
Try another category, or add the first component to this library so the page has something to show.
Appearance is not enough. This is the contract for when the control earns a place in the product.
Use when a list, canvas, or inbox has nothing to show yet — or nothing matches.
Don't force this layout onto a task with a different risk profile or a different set of fields.
Turn an empty surface into a next step instead of a dead end.
Every field in the pattern keeps a visible label, and primary actions remain real buttons. Error copy sits next to the field that failed.
<EmptyState
title="No components match"
body="Try a different category, or add a component to this library."
action="Reset filters"
/>