Empty state
v0.17.3What is missing, why, and the one action that fixes it.
Empty state default
Install
npx shadcn add @syncrobotic/empty-state Also installs: @syncrobotic/cn
Overview
When to use
- A list with no items yet, search with no results, a page without permission.
Use something else
- A temporary error inside a page: Alert.
More examples
States and real uses. Each example is also a Storybook story and a visual regression test.
Empty state no results
Empty state error
Empty state first run
Empty state filtered
Empty state no permission
Empty state offline
Empty state compact
Usage rules
- Says what is missing, why, and the next step as a button. Never a bare “No data”.
- When a filter or search caused it, the action clears it.
Changelog
- 0.17.32026-11-19Balanced wrapping for title and description.
- 0.5.02026-11-17First versioned release. Earlier history is in CHANGELOG.md.