Setup Checklist with Progress
The get-started card that ships with its first item already ticked, a native <progress> element rather than a div bar, and a dismiss control that appears only once there is nothing left to abandon.
The "what best describes you" step, asked honestly — every option states what it actually changes, the skip is visible and names what you get instead, and the choice is reversible.
components/onboarding-role-picker.tsxnpx hoverlab add onboarding-role-picker
Or over MCP, from your editor's agent — no account needed.
Free to read, copy and install, for personal and non-commercial projects. Shipping it in client work or a paid product needs Pro ($79 once). The source lands in your repo and stops being ours — no attribution, nothing to upgrade.
Start a page with this section — add more, order them, and leave with the page source.
Step 1 of 3
This sets what you see first. Nothing here is locked in.
Whatever you pick, you can change it in Settings → Workspace at any time.
Rendered live in your current theme — this is the same component whose source is below, not a screenshot of it.
'use client'
/**
* <OnboardingRolePicker> — "what best describes you", asked honestly.
*
* Onboarding had the checklist, the wizard, the coach mark and the invite
* step: four surfaces about getting work done. This is the one before them
* — the segmentation question nearly every product asks on first run, and
* the one most likely to be asked for the company's benefit while being
* dressed up as a favour to the user.
*
* THE ONE THING THIS GETS RIGHT THAT MOST DO NOT
*
* Every option says what it will change. "Designer" is a label; "we will
* open the canvas first and turn the code panel off" is a consequence
* somebody can agree or object to. If an answer changes nothing, the
* question is analytics wearing a costume, and it should either be cut or
* be labelled as research — which is the honest third option and is why
* the skip below is a plain link and not a greyed-out afterthought.
*
* SKIP IS VISIBLE AND COSTS NOTHING
*
* Hiding the way past a survey is how first-run flows lose the people who
* were most ready to start. The skip states what happens instead — the
* default setup, nameable, not a mystery — so declining is an informed
* choice rather than a gamble.
*
* IT SAYS THAT THIS IS REVERSIBLE
*
* One sentence, under the buttons. Half the hesitation on a screen like
* this is somebody weighing a decision they think is permanent. It is not,
* and saying so is cheaper than any amount of copy about how great the
* product is.
*
* ACCESSIBILITY: real radio inputs in a `<fieldset>` with a `<legend>`,
* visually hidden but present, so arrow keys move within the group and the
* screen reader announces "3 of 5". Cards built from divs and `onClick`
* are the standard version of this screen and they are unreachable by
* keyboard, unannounced as a group, and impossible to submit.
*/
import * as React from 'react'
import { ArrowRight, Code2, LineChart, PenTool, Users } from 'lucide-react'
export interface OnboardingRole {
id: string
label: string
/** What actually changes if this is chosen. Never a restatement. */
consequence: string
icon: React.ComponentType<{ className?: string }>
}
export interface OnboardingRolePickerProps {
productName?: string
roles?: OnboardingRole[]
/** What the skip path gives you — named, not left as a mystery. */
defaultSetup?: string
className?: string
}
const DEFAULT_ROLES: OnboardingRole[] = [
{
id: 'engineer',
label: 'Engineer',
consequence:
'Opens the code panel first, installs the CLI, and shows diffs instead of previews.',
icon: Code2,
},
{
id: 'designer',
label: 'Designer',
consequence:
'Opens the canvas first, hides the code panel, and turns on the Figma import.',
icon: PenTool,
},
{
id: 'pm',
label: 'Product or project lead',
consequence:
'Starts on the roadmap view, and weekly summaries are switched on by default.',
icon: LineChart,
},
{
id: 'ops',
label: 'Operations or support',
consequence:
'Starts on the queue, with keyboard shortcuts and bulk actions enabled.',
icon: Users,
},
]
export function OnboardingRolePicker({
productName = 'Northwind',
roles = DEFAULT_ROLES,
defaultSetup = 'the engineer setup, which is what most people keep',
className = '',
}: OnboardingRolePickerProps) {
const [role, setRole] = React.useState<string | null>(null)
const chosen = roles.find((r) => r.id === role)
return (
<section className={`mx-auto w-full max-w-2xl px-4 py-16 sm:px-6 ${className}`}>
<div className="rounded-2xl border border-border bg-card p-6 sm:p-8">
<p className="text-xs font-medium uppercase tracking-wide text-muted-foreground">
Step 1 of 3
</p>
<h1 className="mt-2 text-2xl font-semibold tracking-tight text-foreground">
What will you be doing in {productName}?
</h1>
<p className="mt-2 text-sm text-muted-foreground">
This sets what you see first. Nothing here is locked in.
</p>
{/*
A real fieldset and real radios. The div-and-onClick version of
this card grid is unreachable by keyboard and silent to a screen
reader, and it is the version almost everybody ships.
*/}
<fieldset className="mt-6">
<legend className="sr-only">Choose the description that fits you best</legend>
<div className="grid gap-3 md:grid-cols-2">
{roles.map((r) => {
const Icon = r.icon
const selected = role === r.id
return (
<label
key={r.id}
className={`relative flex cursor-pointer gap-3 rounded-xl border p-4 transition focus-within:ring-2 focus-within:ring-ring focus-within:ring-offset-2 focus-within:ring-offset-background ${
selected
? 'border-primary bg-accent/60'
: 'border-border bg-background hover:bg-muted'
}`}
>
<input
type="radio"
name="onboarding-role"
value={r.id}
checked={selected}
onChange={() => setRole(r.id)}
/*
accent-primary rather than a hand-drawn dot: the
tokens are oklch(), so hsl(var(--primary)) is not a
colour and the control renders browser-blue.
*/
className="mt-0.5 h-4 w-4 shrink-0 border-field accent-primary focus:outline-none"
/>
<span className="min-w-0 flex-1">
<span className="flex items-center gap-1.5 text-sm font-medium text-foreground">
<Icon aria-hidden className="h-4 w-4 shrink-0 text-muted-foreground" />
{r.label}
</span>
{/* The consequence, not a restatement of the label. */}
<span className="mt-1 block text-xs leading-relaxed text-muted-foreground">
{r.consequence}
</span>
</span>
</label>
)
})}
</div>
</fieldset>
<div className="mt-6 flex flex-wrap items-center gap-x-4 gap-y-3">
<button
type="button"
disabled={!chosen}
className="inline-flex h-10 items-center gap-1.5 rounded-lg bg-primary px-4 text-sm font-semibold text-primary-foreground transition hover:opacity-90 disabled:pointer-events-none disabled:opacity-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
>
Continue
<ArrowRight aria-hidden className="h-4 w-4 rtl:rotate-180" />
</button>
{/* Visible, plain, and it names what you get instead. */}
<button
type="button"
className="rounded text-sm text-muted-foreground underline underline-offset-4 transition hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
>
Skip — give me {defaultSetup}
</button>
</div>
<p role="status" className="mt-4 text-xs text-muted-foreground">
{chosen
? `${chosen.label} selected. ${chosen.consequence} You can change this in Settings → Workspace at any time.`
: 'Whatever you pick, you can change it in Settings → Workspace at any time.'}
</p>
</div>
</section>
)
}
bg-card, text-muted-foreground) — it inherits your theme instead of overriding it.Drop it at components/onboarding-role-picker.tsx and import it where you need the section:
import { OnboardingRolePicker } from '@/components/onboarding-role-picker'2 of this block’s props are simple enough to drive from here. Change them and the block below re-renders — it is the same component whose source is above, not a mock of it. Everything else it accepts is in the table underneath.
Read out of the component’s own type and signature, so this cannot drift from the source below. Every prop has a default — the component renders standalone before you pass it anything.
| Prop | Type | Default |
|---|---|---|
productName | string | 'Northwind' |
roles | OnboardingRole[] | DEFAULT_ROLES |
defaultSetupWhat the skip path gives you — named, not left as a mystery. | string | 'the engineer setup, which is what most peopl… |
className | string | '' |
The same block rendered once to markup, wrapped as a file your framework compiles. Tailwind classes are framework-agnostic, so the design transfers intact — the behaviour does not.
This block is interactive. The markup below is its initial state with the event handlers stripped — you will need to re-wire the behaviour in your framework.
<!--
Role Picker — markup from the Hoverlab catalog.
This is the block rendered once to HTML and wrapped as a component
file. It is not a port of the React source: the Tailwind classes carry
the design, which is the part that took the work, and they are the same
in every framework.
This block is interactive in React and the handlers are NOT here.
Buttons, toggles and menus render in their initial state and do
nothing until you wire them up.
-->
<section class="mx-auto w-full max-w-2xl px-4 py-16 sm:px-6 ">
<div class="rounded-2xl border border-border bg-card p-6 sm:p-8">
<p class="text-xs font-medium uppercase tracking-wide text-muted-foreground">Step 1 of 3</p>
<h1 class="mt-2 text-2xl font-semibold tracking-tight text-foreground">What will you be doing in Northwind?</h1>
<p class="mt-2 text-sm text-muted-foreground">This sets what you see first. Nothing here is locked in.</p>
<fieldset class="mt-6">
<legend class="sr-only">Choose the description that fits you best</legend>
<div class="grid gap-3 md:grid-cols-2">
<label class="relative flex cursor-pointer gap-3 rounded-xl border p-4 transition focus-within:ring-2 focus-within:ring-ring focus-within:ring-offset-2 focus-within:ring-offset-background border-border bg-background hover:bg-muted">
<input type="radio" class="mt-0.5 h-4 w-4 shrink-0 border-field accent-primary focus:outline-none" name="onboarding-role" value="engineer" />
<span class="min-w-0 flex-1">
<span class="flex items-center gap-1.5 text-sm font-medium text-foreground"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-code-xml h-4 w-4 shrink-0 text-muted-foreground" aria-hidden="true"><path d="m18 16 4-4-4-4"></path><path d="m6 8-4 4 4 4"></path><path d="m14.5 4-5 16"></path></svg>Engineer</span>
<span class="mt-1 block text-xs leading-relaxed text-muted-foreground">Opens the code panel first, installs the CLI, and shows diffs instead of previews.</span>
</span>
</label>
<label class="relative flex cursor-pointer gap-3 rounded-xl border p-4 transition focus-within:ring-2 focus-within:ring-ring focus-within:ring-offset-2 focus-within:ring-offset-background border-border bg-background hover:bg-muted">
<input type="radio" class="mt-0.5 h-4 w-4 shrink-0 border-field accent-primary focus:outline-none" name="onboarding-role" value="designer" />
<span class="min-w-0 flex-1">
<span class="flex items-center gap-1.5 text-sm font-medium text-foreground"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-pen-tool h-4 w-4 shrink-0 text-muted-foreground" aria-hidden="true"><path d="M15.707 21.293a1 1 0 0 1-1.414 0l-1.586-1.586a1 1 0 0 1 0-1.414l5.586-5.586a1 1 0 0 1 1.414 0l1.586 1.586a1 1 0 0 1 0 1.414z"></path><path d="m18 13-1.375-6.874a1 1 0 0 0-.746-.776L3.235 2.028a1 1 0 0 0-1.207 1.207L5.35 15.879a1 1 0 0 0 .776.746L13 18"></path><path d="m2.3 2.3 7.286 7.286"></path><circle cx="11" cy="11" r="2"></circle></svg>Designer</span>
<span class="mt-1 block text-xs leading-relaxed text-muted-foreground">Opens the canvas first, hides the code panel, and turns on the Figma import.</span>
</span>
</label>
<label class="relative flex cursor-pointer gap-3 rounded-xl border p-4 transition focus-within:ring-2 focus-within:ring-ring focus-within:ring-offset-2 focus-within:ring-offset-background border-border bg-background hover:bg-muted">
<input type="radio" class="mt-0.5 h-4 w-4 shrink-0 border-field accent-primary focus:outline-none" name="onboarding-role" value="pm" />
<span class="min-w-0 flex-1">
<span class="flex items-center gap-1.5 text-sm font-medium text-foreground"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chart-line h-4 w-4 shrink-0 text-muted-foreground" aria-hidden="true"><path d="M3 3v16a2 2 0 0 0 2 2h16"></path><path d="m19 9-5 5-4-4-3 3"></path></svg>Product or project lead</span>
<span class="mt-1 block text-xs leading-relaxed text-muted-foreground">Starts on the roadmap view, and weekly summaries are switched on by default.</span>
</span>
</label>
<label class="relative flex cursor-pointer gap-3 rounded-xl border p-4 transition focus-within:ring-2 focus-within:ring-ring focus-within:ring-offset-2 focus-within:ring-offset-background border-border bg-background hover:bg-muted">
<input type="radio" class="mt-0.5 h-4 w-4 shrink-0 border-field accent-primary focus:outline-none" name="onboarding-role" value="ops" />
<span class="min-w-0 flex-1">
<span class="flex items-center gap-1.5 text-sm font-medium text-foreground"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-users h-4 w-4 shrink-0 text-muted-foreground" aria-hidden="true"><path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"></path><path d="M16 3.128a4 4 0 0 1 0 7.744"></path><path d="M22 21v-2a4 4 0 0 0-3-3.87"></path><circle cx="9" cy="7" r="4"></circle></svg>Operations or support</span>
<span class="mt-1 block text-xs leading-relaxed text-muted-foreground">Starts on the queue, with keyboard shortcuts and bulk actions enabled.</span>
</span>
</label>
</div>
</fieldset>
<div class="mt-6 flex flex-wrap items-center gap-x-4 gap-y-3">
<button type="button" disabled="" class="inline-flex h-10 items-center gap-1.5 rounded-lg bg-primary px-4 text-sm font-semibold text-primary-foreground transition hover:opacity-90 disabled:pointer-events-none disabled:opacity-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background">Continue<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-arrow-right h-4 w-4 rtl:rotate-180" aria-hidden="true"><path d="M5 12h14"></path><path d="m12 5 7 7-7 7"></path></svg></button>
<button type="button" class="rounded text-sm text-muted-foreground underline underline-offset-4 transition hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background">Skip — give me the engineer setup, which is what most people keep</button>
</div>
<p role="status" class="mt-4 text-xs text-muted-foreground">Whatever you pick, you can change it in Settings → Workspace at any time.</p>
</div>
</section>
What each framework gets across the whole catalog — effects convert properly; this rung is markup.
The component, its props, the design tokens it expects and the command that installs it — as one prompt. Paste it into Claude, Cursor, v0 or ChatGPT and what they build around it will match the rest of the catalog instead of inventing its own system.
Want the whole screen instead of this one section? Open a page and copy it entire.
All of them free to read, copy and install — no account, no locked tiles, no watermarked preview. The whole catalog is open, and so are the API and the CLI.
Browse OnboardingCopying the code is free. Putting it in client work or a paid product is what Pro is for — the licence, not the access.
The get-started card that ships with its first item already ticked, a native <progress> element rather than a div bar, and a dismiss control that appears only once there is nothing left to abandon.
A choice-driven wizard with a persistent side rail, real radio groups in a fieldset so arrow keys work, and visited steps navigable while steps ahead stay out of the tab order.
The onboarding step where a product becomes multiplayer: pasted addresses split into chips, typos marked rather than dropped, and an honest way to skip.
A tour step anchored to the control it explains, with a spotlight cut by one spread shadow, a visible step count and focus that follows the step.
The empty product’s real first question. Sample data is offered with equal weight rather than as grey small print, every connector names its scope before the redirect, and each option carries the honest duration.
The first screen after signup, asking only the two things that cannot be changed silently later.
What a migration actually moves and what it cannot, stated before the switch rather than discovered after it.