# EmptyState

Teaches the surface's verb, in voice; never 'nothing here.' Two variants: panel and inline.

Install: `npx candlelight-ds add empty-state`

Category: primitive · Grammar: G5

## Use when

A list or region has no content yet and there is a next verb to teach.

## Don't use when

Content is loading (Skeleton) or an error needs naming.

## States

- panel
- inline
- with action

## Keyboard

- (none — pointer/semantic only)

## Acceptance tests

- The title is a verb in the product's voice, never 'No items found.'

## Files

- components/ui/EmptyState.tsx

npm dependencies: @candlelight-ds/tokens, clsx, tailwind-merge

Rendered twin: https://candlelight-docs.vercel.app/components/empty-state · Full spec: https://candlelight-docs.vercel.app/spec.md