# Empty State

An empty list that shows what is missing and turns into it: the card in the drawing becomes your first project, ready to rename.

Install with

```bash
npx shadcn@latest add https://kokonutui.com/r/empty-state.json, then show me how to use it.
```

lucide-react, motion

## Installation

Empty State is a free, open-source React component in the Kokonut UI [Feedback collection](/content/docs/feedback/index.html). Add it with the shadcn CLI, which copies the source into `components/kokonutui/empty-state.tsx`, so the code is yours to change.

Or add it by hand: install its packages, then copy the source from above into `components/kokonutui/empty-state.tsx`.

```bash
npm install lucide-react motion
```

## Usage

```javascript
import EmptyState from "@/components/kokonutui/empty-state";

export default function Example() {
  return <EmptyState />;
}
```

## Props

- `title`  
  **Type**: `string`  
  **Default**: "No projects yet"
- `description`  
  **Type**: `string`  
  **Default**: "A project keeps your pages, assets and deploys…"
- `onCreate`  
  **Type**: `(project: EmptyProject) => void`
- `className`  
  **Type**: `string`  
  Extra classes for the root element.

### EmptyProject

- `id`  
  **Type**: `number`  
  **Required**
- `name`  
  **Type**: `string`  
  **Required**
- `from`  
  **Type**: `"new" | "github"`  
  **Required**

## Dependencies

| Needs                            | Version   | Comes from                     |
|----------------------------------|-----------|--------------------------------|
| `lucide-react`                   | `^0.556.0`| npm, installed by the CLI      |
| `motion`                         | `^12.23.25`| npm, installed by the CLI      |
| `cn` from `lib/utils.ts`        |           | shadcn init                    |
| React                            | `19`     | Your app                       |
| Tailwind CSS                     | `4`      | Your app                       |

No provider, font or global CSS to set up: the file works as soon as it lands.
