Uai

authenticationonboarding-wizard.tsx

Color theme

block · 47/108

Onboarding Wizard

Resumable setup steps with validation, progress, optional steps, and completion.

Install

Install manuallyView source on GitHub

Composes

  • onboarding-wizard.tsx18
  • form-field.tsx3
  • status-banner.tsx1
  • step-indicator.tsx2

Accessibility4 checks

  • Progress renders as a Step Indicator list; the current step carries aria-current="step" and every status is spoken in text, not color.
  • Each step is a fieldset named by its heading; focus moves to the new heading when the step changes, and the step count is announced politely.
  • Continue runs native field validation first, focuses the first invalid field, and shows the message in an alert Status Banner.
  • Reached steps become buttons in the progress list, so keyboard users can return to earlier answers without losing them.
canvasvariant="sidebar"authentication
Authentication and onboarding

Step 1 of 1

Set up Ferrow Routes

Your progress is saved after each step, so you can finish later.

  1. Your profile

    Name and role

    Current
  2. Daily routes

    Stops and depot

    Upcoming
  3. Calendar

    Sync bookings

    Upcoming

Tell us about you

onboarding wizard variant

Code example

usage.tsx
"use client";import { useState } from "react";import {  OnboardingWizard,  OnboardingWizardBack,  OnboardingWizardBody,  OnboardingWizardComplete,  OnboardingWizardDescription,  OnboardingWizardError,  OnboardingWizardFinish,  OnboardingWizardFooter,  OnboardingWizardHeader,  OnboardingWizardNext,  OnboardingWizardPanel,  OnboardingWizardPanelDescription,  OnboardingWizardPanelTitle,  OnboardingWizardProgress,  OnboardingWizardProgressStep,  OnboardingWizardSkip,  OnboardingWizardStepCount,  OnboardingWizardTitle,  type OnboardingWizardVariant,} from "@/components/uai/onboarding-wizard";import { FormField, FormFieldInput, FormFieldLabel } from "@/components/ui/uai/form-field";import { StatusBannerTitle } from "@/components/ui/uai/status-banner";import { StepIndicatorDescription, StepIndicatorTitle } from "@/components/ui/uai/step-indicator";export function OnboardingWizardPreview({  variant = "sidebar",}: {  variant?: OnboardingWizardVariant;}) {  // Persist this value (for example per account) to resume setup later.  const [step, setStep] = useState("profile");  const [stops, setStops] = useState("");  return (    <OnboardingWizard      variant={variant}      value={step}      onValueChange={setStep}      onComplete={() => new Promise((resolve) => setTimeout(resolve, 600))}    >      <OnboardingWizardHeader>        <OnboardingWizardStepCount />        <OnboardingWizardTitle>Set up Ferrow Routes</OnboardingWizardTitle>        <OnboardingWizardDescription>          Your progress is saved after each step, so you can finish later.        </OnboardingWizardDescription>      </OnboardingWizardHeader>      <OnboardingWizardProgress>        <OnboardingWizardProgressStep value="profile">          <StepIndicatorTitle>Your profile</StepIndicatorTitle>          <StepIndicatorDescription>Name and role</StepIndicatorDescription>        </OnboardingWizardProgressStep>        <OnboardingWizardProgressStep value="routes">          <StepIndicatorTitle>Daily routes</StepIndicatorTitle>          <StepIndicatorDescription>Stops and depot</StepIndicatorDescription>        </OnboardingWizardProgressStep>        <OnboardingWizardProgressStep value="calendar">          <StepIndicatorTitle>Calendar</StepIndicatorTitle>          <StepIndicatorDescription>Sync bookings</StepIndicatorDescription>        </OnboardingWizardProgressStep>      </OnboardingWizardProgress>      <OnboardingWizardBody>        <OnboardingWizardPanel value="profile">          <OnboardingWizardPanelTitle>Tell us about you</OnboardingWizardPanelTitle>          <FormField variant="compact" required>            <FormFieldLabel>Full name</FormFieldLabel>            <FormFieldInput name="name" autoComplete="name" placeholder="Marta Okafor" />          </FormField>          <FormField variant="compact">            <FormFieldLabel>Role</FormFieldLabel>            <FormFieldInput              name="role"              autoComplete="organization-title"              placeholder="Dispatcher"            />          </FormField>        </OnboardingWizardPanel>        <OnboardingWizardPanel          value="routes"          validate={() =>            Number(stops) > 0 ? null : "Enter how many stops your crews make on a typical day."          }        >          <OnboardingWizardPanelTitle>Plan your daily routes</OnboardingWizardPanelTitle>          <OnboardingWizardPanelDescription>            We use this to size your first schedule. You can change it later.          </OnboardingWizardPanelDescription>          <FormField variant="compact" value={stops} onValueChange={setStops}>            <FormFieldLabel>Stops per day</FormFieldLabel>            <FormFieldInput name="stops" inputMode="numeric" placeholder="24" />          </FormField>          <FormField variant="compact">            <FormFieldLabel>Depot address</FormFieldLabel>            <FormFieldInput name="depot" autoComplete="street-address" placeholder="18 Mill Lane" />          </FormField>        </OnboardingWizardPanel>        <OnboardingWizardPanel value="calendar" optional>          <OnboardingWizardPanelTitle>Connect a calendar</OnboardingWizardPanelTitle>          <OnboardingWizardPanelDescription>            Bookings from a shared calendar become stops automatically.          </OnboardingWizardPanelDescription>          <FormField variant="compact">            <FormFieldLabel>Calendar address</FormFieldLabel>            <FormFieldInput name="calendar" type="email" placeholder="bookings@larkspur.example" />          </FormField>        </OnboardingWizardPanel>        <OnboardingWizardError>          <StatusBannerTitle>Check this step</StatusBannerTitle>        </OnboardingWizardError>        <OnboardingWizardComplete>          <strong>You’re all set</strong>          <span style={{ color: "var(--uai-muted)" }}>            Your first schedule is ready in Ferrow Routes.          </span>        </OnboardingWizardComplete>        <OnboardingWizardFooter>          <OnboardingWizardBack>Back</OnboardingWizardBack>          <OnboardingWizardSkip>Skip for now</OnboardingWizardSkip>          <OnboardingWizardNext>Continue</OnboardingWizardNext>          <OnboardingWizardFinish>Finish setup</OnboardingWizardFinish>        </OnboardingWizardFooter>      </OnboardingWizardBody>    </OnboardingWizard>  );}

Manual installation

onboarding-wizard.tsx

Loading component source…

esc
ThinkingAI
MessageAI
CitationAI
AttachmentAI
Tool CallAI
Response StatusAI
Run SummaryAI
Conversation ThreadAI · Block
Research SessionAI · Block
File AnalysisAI · Block
Agent RunAI · Block
Approval CardFeedback
Empty StateFeedback
Status BannerFeedback
Progress SummaryFeedback
Inline FeedbackFeedback
Confirmation DialogFeedback
Activity TimelineFeedback
Skeleton GroupFeedback
Prompt ComposerForms
Form FieldForms
Search FieldForms
Filter BarForms
File UploadForms
Date Range PickerForms
Form Error SummaryForms
Unsaved Changes BarForms
Step IndicatorForms
Task ListData Display
Data Table ToolbarData Display
Metric CardData Display
Description ListData Display
Comparison TableData Display
Kanban BoardData Display
Calendar ViewData Display
Audit LogData Display
App HeaderNavigation
App SidebarNavigation
Breadcrumb TrailNavigation
Page TabsNavigation
Command MenuNavigation
Split PaneNavigation
Sign-in CardAuthentication
Sign-up CardAuthentication
Password RecoveryAuthentication
Code VerificationAuthentication · Block
Onboarding WizardAuthentication · Block
Workspace SetupAuthentication · Block
Coupon FieldCommerce
Quantity PickerCommerce
Cart ItemCommerce
Price SummaryCommerce
Order StatusCommerce
Product DetailCommerce · Block
Product ListingCommerce · Block
Cart DrawerCommerce · Block
CheckoutCommerce · Block
Order TrackingCommerce · Block
Subscription ManagementCommerce · Block
Announcement BarMarketing
Pricing ToggleMarketing
Testimonial CardMarketing
Product GalleryMarketing
Trust PanelMarketing
Newsletter FormMarketing
Hero SectionMarketing · Block
Feature ShowcaseMarketing · Block
Pricing SectionMarketing · Block
Testimonials SectionMarketing · Block
FAQ SectionMarketing · Block
Call to ActionMarketing · Block
Waitlist SectionMarketing · Block
Contact SectionMarketing · Block
Author CardContent
CommentContent
Reaction BarContent
Share MenuContent
Changelog EntryContent
Article PageContent · Block
Documentation PageContent · Block
Changelog PageContent · Block
Comment ThreadContent · Block
Community FeedContent · Block
Public ProfileContent · Block
Map FrameMaps
Map ControlsMaps
Map MarkerMaps
Map LegendMaps
Place CardMaps
Route SummaryMaps
Dashboard ShellApplication · Block
Settings PageApplication · Block
Profile PageApplication · Block
Team ManagementApplication · Block
Notification CenterApplication · Block
Billing PortalApplication · Block
Search ResultsApplication · Block
Resource ManagerOperations · Block
Data ExplorerOperations · Block
Import WorkflowOperations · Block
Approval QueueOperations · Block
Audit Log ViewerOperations · Block
Incident DashboardOperations · Block
Report BuilderOperations · Block
Document FieldBrazil
CEP FieldBrazil
Pix PaymentBrazil
Installment PickerBrazil