Skip to content
Product block

Role Picker

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.

191 lineslucide-reactAdded 27 Aug 2026Updated 10 Sept 2026
  • onboarding
  • segmentation
  • role
  • first run
  • radio

What's included

  • components/onboarding-role-picker.tsx
  • Needs lucide-react

Works with

  • React
  • Next.js
  • Tailwind CSS
  • TypeScript

npx hoverlab add onboarding-role-picker

Or over MCP, from your editor's agent — no account needed.

License

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.

Was this useful?

Start a page with this section — add more, order them, and leave with the page source.

Preview

Step 1 of 3

What will you be doing in Northwind?

This sets what you see first. Nothing here is locked in.

Choose the description that fits you best

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.

Source

components/onboarding-role-picker.tsx
'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>
  )
}

Before you paste

  • Styling is Tailwind utility classes on semantic tokens (bg-card, text-muted-foreground) — it inherits your theme instead of overriding it.
  • Install: npm i lucide-react
  • Every prop has a default, so it renders standalone before you wire it up.

Where it goes

Drop it at components/onboarding-role-picker.tsx and import it where you need the section:

import { OnboardingRolePicker } from '@/components/onboarding-role-picker'

Customize

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.

Props

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.

PropTypeDefault
productNamestring'Northwind'
rolesOnboardingRole[]DEFAULT_ROLES
defaultSetupWhat the skip path gives you — named, not left as a mystery.string'the engineer setup, which is what most peopl…
classNamestring''

Not using React?

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.

onboarding-role-picker.html
<!--
  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>
  • This is rendered HTML, not a translation of the React source. The Tailwind classes carry the design and work in any framework.
  • It is one frame: the component in its initial state, with no props applied beyond the defaults.
  • This block is interactive in React — toggles, menus or form state. None of that survives here; the markup is the closed/default state and the handlers are gone. Re-wire them in your own framework.
  • Requires Tailwind, and the design tokens the classes reference (bg-card, text-muted-foreground, and so on). The template ZIPs ship a globals.css that defines them.

What each framework gets across the whole catalog — effects convert properly; this rung is markup.

For AI

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.

See the prompt

Used in these pages

Want the whole screen instead of this one section? Open a page and copy it entire.

7 more blocks in Onboarding

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 Onboarding

Shipping one commercially

Copying the code is free. Putting it in client work or a paid product is what Pro is for — the licence, not the access.

  • A commercial licence for everything in the catalog
  • Unlimited bundle exports, in Vue, Svelte and Tailwind
  • One payment — no subscription, nothing to renew
Pro — $79 once

More Onboarding blocks

View category
Open the full page for this block

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.

Onboarding230 lines1 dep
Open the full page for this block

Guided Setup Wizard

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.

Onboarding265 lines1 dep
Open the full page for this block

Team Invite Step

The onboarding step where a product becomes multiplayer: pasted addresses split into chips, typos marked rather than dropped, and an honest way to skip.

Onboarding279 lines1 dep
Open the full page for this block

Product Tour Coach Mark

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.

Onboarding262 lines1 dep
Open the full page for this block

Import or Start Empty

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.

Onboarding216 lines1 dep
Open the full page for this block

Workspace Setup Form

The first screen after signup, asking only the two things that cannot be changed silently later.

Onboarding176 linesNo deps
Open the full page for this block

Data Migration Split

What a migration actually moves and what it cannot, stated before the switch rather than discovered after it.

Onboarding158 linesNo deps