Ballmac UI home

Empty State

A ready-to-use empty screen with guidance and primary and secondary action slots.

Your workspace is ready

Create a project to keep tasks, files, and updates together.

Installation

$ pnpm dlx shadcn@latest add @ballmac/empty-state

Usage

import { EmptyState } from "@/components/ballmac/empty-state"

The full example is in the Code tab above.

Examples

States and variants

No results found

Try a different search term or remove a filter.

API reference

PropTypeDefault
title*

Plain-language explanation of what is missing.

string—
description*

Next-step guidance.

string—
icon

Decorative icon; defaults to an inbox.

React.ReactNode—
action

Primary action, usually a link or button.

React.ReactNode—
secondaryAction

Optional secondary action.

React.ReactNode—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
Tab / EnterFocus and activate supplied actions

Use with AI

A ready-to-use empty screen with guidance and primary and secondary action slots. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Empty State (@ballmac/empty-state) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Explain an empty collection
  • Offer a clear first action

Not for

  • Use empty for a custom composition

Registry JSON: https://ui.ballmac.com/r/empty-state.json

Credits

Free to use in personal and commercial projects.