Empty state

Empty state is a neobrutalist React component from Cruise UI. What a list or page shows with nothing in it: an icon, a heading, one line and the next step. Install it with npx shadcn@latest add @cruiseui/empty-state.

Install

Terminal

npx shadcn@latest add @cruiseui/empty-state

First time? Installation shows the one-off components.json setup (the @cruiseui registry) and how to turn the theme on.

Example

Corners

No orders yet

When you buy something, it shows up here.

No results for “agbada”

Check the spelling or try a shorter word.

You're offline

We'll load your orders when you're back online.

Get help

When to use it

When to use

Empty lists, searches with no results, offline screens, first-time pages.

When not to

Errors that need fixing (use an Alert). Loading (use a Skeleton).

Props

CruiseEmptyState

PropTypeDefaultDescription
icon?ReactNode—Default: Lucide inbox.
titleReactNode——
description?ReactNode——
action?ReactNode—The main action, e.g. a CruiseButton.
secondary?ReactNode—A secondary link.
size?"inline" | "page""inline"—
headingLevel?4 | 3 | 22Heading level for the title (2 for a page, 3 inside a card).
className?string——

Accessibility

  • The heading is a real heading (choose its level).
  • The icon is decorative; the heading and line say what happened.
  • The action is a real button or link.