Skip to content
shadcn.io

shadcn.io is not affiliated with official shadcn/ui

Getting Started Empty State Block for React

A getting-started card for an empty dashboard: four setup steps as real checkboxes, a headline that counts down with a progress bar, and a drawn trail up a hill with a flag that stands at the done count.

Framework
UI library

Preview

Preview width

Installation

Part of Pro
Pro unlocks the code and one-line install of every Pro button and text effect, plus the MCP for your AI editor.
Have Pro already? Sign in to open it.Opens here as soon as you're Pro.

Overview

Show a new account how far it has come, with this getting started empty state for React with Base UI. A hairline frame with a plus mark on each corner holds the checklist card that sits on Alderly's empty dashboard, a CRM for small businesses. A headline counts down from "3 steps to go" to "You are set up" beside "1 of 4 done", over a Progress bar in the foreground color. Four steps (set up your profile, start your first project, invite a teammate, connect one tool) are real Checkbox rows with the first open one marked Next in words; beside them a greyscale drawing of a trail up a hill has four waypoints and a flag that walks to the done count, the stretches still ahead dashed and the ones walked solid. The Shine Button, the only colored control, names the next step and ticks it in the demo; when all four are done it opens the dashboard. The frame's bands are ruled by Guides, and everything moves with CSS transitions only. For the first-run card of any app with a short setup.

FAQ

What stays in the page, and how do I make the steps real?

The ticked steps live in the page's state and nothing is saved or sent: reload and "Set up your profile" is the only step done. For the real thing, start START from your account's completed steps and save each tick where the code says so. Make the button a link to the next step's own page instead of ticking it, and let the checkboxes show what your product already knows is done.

How is Next chosen, and can I do the steps in any order?

Next is the first step that is still open, so it moves as steps are ticked; any step can be ticked or unticked in any order, and the headline, the count, the bar, the trail and the button's label all follow. Done and Next are written as words, never only as a color.

How does the drawing react without moving anything?

It is one inline SVG that only changes classes: each stretch of trail has a dashed copy and a solid copy that fades in when that stretch has been walked, the waypoints fill in, and the flag moves to the done count with a transition on its position. Reduced motion switches the transitions off. The drawing is decorative and hidden from screen readers; the checklist, the headline and the status line say the same thing in words.

Is it usable with a keyboard and a screen reader?

Tab visits each checkbox, then the button, then Start over, which stays quiet (and says so if pressed) until something has changed. Each checkbox is named by its step and described by its hint, and a click anywhere on the row ticks it. Every change is written to a polite status line in the pinned foot ("Start your first project: done."). The progress bar is decorative because the count is in the text beside it.

How does it look on a phone?

The trail moves above the list and shrinks to 110 px tall, with the list under it. The foot, with the status line and the button, stays pinned to the bottom of the screen while the card scrolls under it, so the next step is always one tap away.

Does the card change height as steps are done?

No. The headline, the count and the Next marker change text in places that already have their room, and the button keeps one line. Start over is always there, quiet until something has changed, so the button never moves.

  • Pro

    A full-height welcome page for a fresh workspace: an isometric plan of an empty studio whose four rooms are a choice group, one sentence about the room you picked, and one Create your first project link.

  • Pro

    A full-height first-run screen for a weekly planner: a name field and one Create project button at the start, and at the end a drawn drafting table whose blank sheet is only dashed until the project exists.

  • Pro

    A full-height invite page for a team chat app: a drawn round table with five chairs that fill as email chips are added, a role select with a sentence per role, and one button that counts the invites and lists them.

  • Pro

    No Tasks Empty State

    Projects and tasks

    An empty three-column task board: dashed slots in To do, Doing and Done, an Add task in each column that opens an inline field, a select on each card to move it, and a message band with a drawn field of slots and one button.

  • Pro

    A notification settings panel: a channel strip with all-or-nothing checkboxes, a matrix of switches by activity and channel with a locked security email, quiet hours, and a save bar that counts unsaved changes.

  • Pro

    Connect Tools Empty State

    Apps and integrations

    A full-height first-run screen for an integration hub: six tool cards with checkboxes at the end, and at the start a drawn hub whose spokes turn from dashed to solid, and whose sockets take a lettermark, as each tool is ticked.