Empty State

Placeholder for empty lists, no search results and errors, with an icon, headline, short message and action. Soft light falls from the top as the content fades in.

Preview

Props Changes apply to the live preview above.

Installation

npx @lumioui/cli add empty-state

Usage

import { EmptyState } from "@/components/ui/empty-state/empty-state";
<EmptyState />

Examples

Variants

A task app's Today list.

API reference

Prop Type Default
title* string

Headline.

—
variant "default" | "search" | "error"

Visual tone. Default "default".

"default"
icon React.ReactNode

Icon slot rendered in the lit well. Defaults to a Lumio glyph per variant.

—
description string

Supporting copy.

—
action React.ReactNode

Optional action slot (e.g. a <Button>).

—
lit boolean

Light the stage from above in the surface accent. Default true.

true
className string —