DS0
Patterns

Empty State

A placeholder shown when a content area has no data, with optional illustration, heading, description, and action.

Overview

The EmptyState recipe provides a centered placeholder for empty content areas. It includes an optional icon/illustration, heading, description, and primary/secondary action buttons.

No results found

Try adjusting your search or filters to find what you're looking for.

Usage

import { EmptyState } from '@/recipes/empty-state';

<EmptyState
  icon={<InboxIcon className="h-12 w-12" />}
  title="No results found"
  description="Try adjusting your search or filters."
  action={{ label: 'Clear filters', onClick: handleClear }}
  secondaryAction={{ label: 'Learn more', onClick: showHelp }}
/>

API Reference

PropTypeDefaultDescription
iconReactNodeβ€”Illustration or icon
titlestringβ€”Heading text
descriptionstringβ€”Supporting description
action{ label: string; onClick: () => void }β€”Primary action button
secondaryAction{ label: string; onClick: () => void }β€”Secondary action button
classNamestringβ€”Additional CSS classes

On this page