# First-Run Empty State

> An empty-state panel for a projects list that lets a first-time user create a new project or import one from GitHub, replacing itself with the project list once items exist.

- Author: [Mohammad Shehadeh](https://21st.dev/@mohammadshehadeh)
- Library: [Hirael](https://21st.dev/@mohammadshehadeh/library/hirael)
- License: MIT
- Tags: Empty State, Onboarding, Dialog
- npm dependencies: lucide-react
- Live preview: https://21st.dev/@mohammadshehadeh/components/empty-state-01

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/mohammadshehadeh/empty-state-01?api_key=$API_KEY_21ST"
```

Requires a 21st API key (generate one at https://21st.dev/mcp) passed as `API_KEY_21ST`. Free accounts get a limited number of installs per day; unlimited on a paid plan — see https://21st.dev/pricing.

Full component directory: https://21st.dev/llms.txt · More like this: https://21st.dev/community/components/s/empty-state.md