Empty State
No-data screen. Free, MIT · Data and metrics › Cards
Installation
npx valyro-cli@latest add empty-state
npx shadcn@latest add https://valyro.xyz/r/empty-state.json
npm install valyro-ui
import 'valyro-ui/styles.css';
import { EmptyState } from 'valyro-ui';
Props
| Prop | Type | Default | |
|---|---|---|---|
icon | ReactNode | <InboxIcon /> | Shown in a tile above the title. Defaults to an inbox icon; pass null to hide. |
title * | ReactNode | Heading (an <h3>), e.g. "No projects yet". | |
description | ReactNode | Muted text under the title explaining the state or the next step. | |
primaryAction | ReactNode | Main call to action, e.g. a <Button>. Placed after the secondary one; stacks on top when the row wraps. | |
secondaryAction | ReactNode | Less prominent action shown before the primary one, e.g. "Learn more". | |
size | 'sm' | 'md' | 'lg' | 'md' | Icon tile, title size and padding; sm fits inside tables and panels, lg fills a page. |
bordered | boolean | false | Dashed outline around the whole state, e.g. as a drop-zone-like placeholder. |
Related components
- Card — All-purpose cards
- Item Card — Row card: icon, title, description and a control on the right
- Record Card — Record card: status, context, key fields and actions
- Carousel — Carousel: scroll snap, swipe, autoplay, thumbnails
- Data Table — Tables with search and sorting
- Data Grid — Grid for 100,000 rows: grouping, filters, inline editing
- Virtual List — Virtual list for 100,000 rows
- Bulk Action Bar — Actions for selected rows, with keyboard shortcuts
- List Block — List with images or icons, descriptions and values
- Description List — Key–value list: stacked, inline or a grid with icons
- Tree View — Tree structures
- Accordion — Collapsible sections
Previous: Carousel · Next: Stats Card · All Data and metrics