Empty

Feedback

Explains an empty collection or unavailable result and creates space for a useful next step.

React · copy into your project · light and dark themes

Try it

Room for your first idea

Add a note to start collecting what matters.

Some notes are still loading

This is an example of an empty state.

Could not load notes

This is an example of an empty state.

No matches

Try another search.

Loading preview…

Take it with you

Copy the example, API and usage notes for your editor or AI assistant.

Add to your project

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/empty.json

The command includes the component’s shared dependencies. Your project keeps editable source files.

Include the complete example

This example also composes button, card, shape, presence. Install its parts together:

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/button.json https://luv-jeri.github.io/cojeev-ui/r/card.json https://luv-jeri.github.io/cojeev-ui/r/empty.json https://luv-jeri.github.io/cojeev-ui/r/shape.json https://luv-jeri.github.io/cojeev-ui/r/presence.json

Using empty

Use EmptyTitle and EmptyDescription to distinguish a new collection from a search with no results.
Add a clear action such as creating an item or clearing a filter when that action is available.

API

Compose the exported parts below. The prop types are read from the React source during the registry build.

Native element or underlying primitive props are inherited where declared, including accessible labels, event handlers and refs.

EmptyProps

Prop	Type	Required
`variant`	`"default" \| null \| undefined`	No
`size`	`"default" \| null \| undefined`	No
`as`	`React.ElementType`	No

EmptyTitleProps

Prop	Type	Required
`variant`	`"default" \| null \| undefined`	No
`size`	`"default" \| null \| undefined`	No
`as`	`React.ElementType`	No

EmptyDescriptionProps

Prop	Type	Required
`variant`	`"default" \| null \| undefined`	No
`size`	`"default" \| null \| undefined`	No
`as`	`React.ElementType`	No

EmptyStateProps

Prop	Type	Required
`variant`	`"default" \| "partial" \| "error" \| "filtered" \| null \| undefined`	No
`size`	`"default" \| null \| undefined`	No
`as`	`React.ElementType`	No

EmptyStateTitleProps

Prop	Type	Required
`variant`	`"default" \| null \| undefined`	No
`size`	`"default" \| null \| undefined`	No
`as`	`React.ElementType`	No

EmptyStateDescriptionProps

Prop	Type	Required
`variant`	`"default" \| null \| undefined`	No
`size`	`"default" \| null \| undefined`	No
`as`	`React.ElementType`	No

Accessibility

Use a meaningful heading and description; announce a dynamically changed result separately when the workflow requires it.

States and appearance

resthoverfocusactive

For conditional content, keep a MotionPresence boundary around keyed MotionSurface children. The shared entrance and exit states work with native primitives and respect your motion preference.

Try pointer and keyboard interaction, and switch the appearance control in the navigation to compare light and dark mode. Motion respects reduced motion preferences.