AddThisFeature

Beautiful Empty States

Replace blank screens with useful, contextual empty states.

simple UI & Polish

What it adds

Every list, table, and dashboard in your app has a "nothing here yet" state. Most
apps ship a blank rectangle — and it is often the very first thing a new user sees.

An empty state should say what belongs here, why it is empty, and what to do next.

What your agent is told to do

4
  1. 1

    Inventory the empty cases first. List every collection view in the app and

  2. 2

    Distinguish the three kinds of empty. They are not the same, and must not

  3. 3

    Build one reusable empty-state component from the existing design system,

  4. 4

    Use the app's existing icon set. Do not add a new icon library.

Edge cases it handles

4
  • Loading is not empty. Do not flash the empty state while data is still
  • Error is not empty. A failed request is an error state.
  • The user cannot create. Do not show a "Create" action they lack permission for.
  • Pagination. Page 3 of a 2-page list is a filtered empty, not a first-run empty.

Definition of done

7
  • Every collection view in the app has an empty state.
  • First-run, filtered, and cleared empties are worded differently.
  • The empty state never appears during loading or on error.
  • One reusable component, built from the existing design system.
  • Actions are wired to the app's real handlers.
  • It reads correctly at a 320px viewport.
  • Screen readers announce the state.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.