# V form 8

> 3-Step Onboarding Wizard

A shadcn/ui block from the [@cnippet](https://ui.cnippet.dev/) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/cnippet/v-form-8).

- Page, with a live preview: https://shadcn.exchange/r/cnippet/v-form-8
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/cnippet/v-form-8-light-14b6f92555d48a23.png
- Registry item: https://ui.cnippet.dev/r/v-form-8.json
- Categories: form
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://ui.cnippet.dev/r/v-form-8.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- Registry items: `@cnippet/form`

## Files

### `registry/default/variants/v-form-8.tsx`

```tsx
"use client";

import { CheckCircle2Icon } from "lucide-react";
import { type FormEvent, useState } from "react";

import { Button } from "@/registry/default/ui/button";
import { Checkbox } from "@/registry/default/ui/checkbox";
import { Field, FieldError, FieldLabel } from "@/registry/default/ui/field";
import { Form } from "@/registry/default/ui/form";
import { Input } from "@/registry/default/ui/input";
import { Label } from "@/registry/default/ui/label";
import { Radio, RadioGroup } from "@/registry/default/ui/radio-group";

const STEPS = ["Account", "Plan", "Confirm"] as const;
type Step = 0 | 1 | 2;

const plans = [
  {
    description: "Free forever, up to 3 projects",
    id: "hobby",
    label: "Hobby",
  },
  { description: "$12/mo — unlimited projects", id: "pro", label: "Pro" },
  { description: "$49/mo — collaboration tools", id: "team", label: "Team" },
];

export function Pattern() {
  const [step, setStep] = useState<Step>(0);
  const [loading, setLoading] = useState(false);
  const [done, setDone] = useState(false);
  const [data, setData] = useState({
    email: "",
    name: "",
    newsletter: true,
    plan: "hobby",
  });

  const handleAccount = (e: FormEvent<HTMLFormElement>) => {
    e.preventDefault();
    const fd = new FormData(e.currentTarget);
    setData((d) => ({
      ...d,
      email: fd.get("email") as string,
      name: fd.get("name") as string,
    }));
    setStep(1);
  };

  const handlePlan = (e: FormEvent<HTMLFormElement>) => {
    e.preventDefault();
    const fd = new FormData(e.currentTarget);
    setData((d) => ({
      ...d,
      newsletter: fd.get("newsletter") === "on",
      plan: fd.get("plan") as string,
    }));
    setStep(2);
  };

  const handleConfirm = async () => {
    setLoading(true);
    await new Promise((r) => setTimeout(r, 1000));
    setLoading(false);
    setDone(true);
  };

  if (done) {
    return (
      <div className="flex w-full max-w-sm flex-col items-center gap-4 py-10 text-center">
        <div className="flex size-12 items-center justify-center rounded-full bg-success/10">
          <CheckCircle2Icon className="size-6 text-success" />
        </div>
        <div className="space-y-1">
          <p className="font-semibold">Account created!</p>
          <p className="text-muted-foreground text-sm">
            Welcome, {data.name}. Check your inbox to verify your email.
          </p>
        </div>
      </div>
    );
  }

  return (
    <div className="w-full max-w-sm space-y-6">
      <div className="flex items-center gap-2">
        {STEPS.map((label, i) => (
          <div className="flex items-center gap-2" key={label}>
            <div className="flex items-center gap-1.5">
              <div
                className={`flex size-6 items-center justify-center rounded-full font-semibold text-xs transition-colors ${
                  i < step
                    ? "bg-primary text-primary-foreground"
                    : i === step
                      ? "border-2 border-primary text-primary"
                      : "border border-border text-muted-foreground"
                }`}
              >
                {i < step ? <CheckCircle2Icon className="size-3.5" /> : i + 1}
              </div>
              <span
                className={`font-medium text-xs ${i === step ? "text-foreground" : "text-muted-foreground"}`}
              >
                {label}
              </span>
            </div>
            {i < STEPS.length - 1 && (
              <div
                className={`h-px min-w-6 flex-1 ${i < step ? "bg-primary" : "bg-border"}`}
              />
            )}
          </div>
        ))}
      </div>

      {step === 0 && (
        <Form className="gap-4" onSubmit={handleAccount}>
          <Field name="name">
            <FieldLabel>Full name</FieldLabel>
            <Input
              defaultValue={data.name}
              placeholder="Alex Rivera"
              required
            />
            <FieldError />
          </Field>
          <Field name="email">
            <FieldLabel>Email</FieldLabel>
            <Input
              defaultValue={data.email}
              placeholder="you@example.com"
              required
              type="email"
            />
            <FieldError />
          </Field>
          <Button className="w-full" type="submit">
            Continue
          </Button>
        </Form>
      )}

      {step === 1 && (
        <Form className="gap-4" onSubmit={handlePlan}>
          <Field name="plan">
            <FieldLabel>Choose a plan</FieldLabel>
            <RadioGroup className="gap-3" defaultValue={data.plan} name="plan">
              {plans.map((p) => (
                <label
                  className="flex cursor-pointer items-start gap-3 rounded-lg border p-3 transition-colors hover:bg-accent/50 has-[input[data-checked]]:border-primary/40 has-[input[data-checked]]:bg-accent/50"
                  key={p.id}
                >
                  <Radio className="mt-0.5" value={p.id} />
                  <div className="flex flex-col gap-0.5">
                    <span className="font-medium text-sm">{p.label}</span>
                    <span className="text-muted-foreground text-xs">
                      {p.description}
                    </span>
                  </div>
                </label>
              ))}
            </RadioGroup>
          </Field>
          <Label className="flex items-center gap-2 font-normal text-sm">
            <Checkbox defaultChecked={data.newsletter} name="newsletter" />
            Send me product updates and tips
          </Label>
          <div className="flex gap-3">
            <Button
              className="flex-1"
              onClick={() => setStep(0)}
              type="button"
              variant="outline"
            >
              Back
            </Button>
            <Button className="flex-1" type="submit">
              Continue
            </Button>
          </div>
        </Form>
      )}

      {step === 2 && (
        <div className="space-y-4">
          <div className="divide-y rounded-lg border">
            {[
              { label: "Name", value: data.name },
              { label: "Email", value: data.email },
              {
                label: "Plan",
                value:
                  plans.find((p) => p.id === data.plan)?.label ?? data.plan,
              },
              { label: "Updates", value: data.newsletter ? "Yes" : "No" },
            ].map(({ label, value }) => (
              <div
                className="flex items-center justify-between px-4 py-3 text-sm"
                key={label}
              >
                <span className="text-muted-foreground">{label}</span>
                <span className="font-medium">{value}</span>
              </div>
            ))}
          </div>
          <div className="flex gap-3">
            <Button
              className="flex-1"
              onClick={() => setStep(1)}
              type="button"
              variant="outline"
            >
              Back
            </Button>
            <Button
              className="flex-1"
              loading={loading}
              onClick={handleConfirm}
            >
              Create account
            </Button>
          </div>
        </div>
      )}
    </div>
  );
}
```