Multi-step Booking Wizard

Booking19: Multi-step Booking Wizard

A single-card booking wizard that walks a customer through four internally-tracked steps (service, schedule, contact, review) with a numbered dot stepper, an animated percentage progress bar, per-step validation gating the Next button, and a final live summary of the selected service, date/time, and contact details.

Installation

Swap YOUR_EMAIL and YOUR_KEY for the email and license key on your account. Find your license key on your account page.

Radix flavor

npx shadcn add "https://ui.beste.co/r/booking19?email=YOUR_EMAIL&license_key=YOUR_KEY"

Base UI flavor

npx shadcn add "https://ui.beste.co/r-base/booking19?email=YOUR_EMAIL&license_key=YOUR_KEY"

This installs the block to components/beste/block/booking19.tsx, plus the badge, button, input, and label shadcn/ui primitives it uses for the eyebrow badge, navigation buttons, and the contact-step form fields.

Quick start

The installed file exports booking19Demo alongside the block: the exact props behind the preview above. Spread it to get a working booking wizard in one line.

import { Booking19, booking19Demo } from "@/components/beste/block/booking19";

export default function Page() {
  return <Booking19 {...booking19Demo} />;
}

Then replace the demo with your own props. Written out, a trimmed setup looks like this:

import { Briefcase, Sparkles } from "lucide-react";
import { Booking19 } from "@/components/beste/block/booking19";

export default function Page() {
  return (
    <Booking19
      badge={{ label: "Multi-step", variant: "secondary" }}
      heading="Book in <strong>four steps</strong>"
      description="A guided wizard for service, schedule, contact, and review."
      currency="$"
      services={[
        {
          value: "consult",
          label: "Strategy Consultation",
          description: "45-minute call to map out your next 90 days",
          duration: "45 min",
          price: 120,
          icon: Briefcase,
        },
        {
          value: "audit",
          label: "Brand Audit",
          description: "In-depth review of your brand touchpoints",
          duration: "90 min",
          price: 240,
          icon: Sparkles,
        },
      ]}
      timeSlots={["09:00", "10:00", "11:00", "13:00", "14:00"]}
      steps={[
        { key: "service", label: "Service", description: "Pick what you need" },
        { key: "schedule", label: "Schedule", description: "Choose a time" },
        { key: "contact", label: "Your details", description: "How we'll reach you" },
        { key: "review", label: "Review", description: "Confirm and book" },
      ]}
      labels={{ nextButton: "Next", backButton: "Back", confirmButton: "Confirm booking" }}
    />
  );
}

Props

type Booking19Service = {
  value: string;
  label: string;
  description: string;
  duration: string;
  price: number;
  icon: LucideIcon;
};

type Booking19Step = {
  key: "service" | "schedule" | "contact" | "review";
  label: string;
  description: string;
};

type Booking19Labels = {
  stepCounterTemplate?: string;
  serviceLabel?: string;
  dateLabel?: string;
  timeLabel?: string;
  nameLabel?: string;
  emailLabel?: string;
  phoneLabel?: string;
  notesLabel?: string;
  namePlaceholder?: string;
  emailPlaceholder?: string;
  phonePlaceholder?: string;
  notesPlaceholder?: string;
  reviewHeading?: string;
  backButton?: string;
  nextButton?: string;
  confirmButton?: string;
  todayLabel?: string;
  totalLabel?: string;
};

Behavior notes

• All wizard state (currentStep, selected service, dateIndex, timeSlot, and the four contact fields) lives in internal useState and is never lifted out; the only externally observable event is handleConfirm, which just does console.log(...), so persisting a booking is left to the integrator.
• Which panel renders is keyed off steps[currentStep].key, not the array position, so a key must be one of "service" \| "schedule" \| "contact" \| "review" to render anything; an unrecognized key shows a blank content area.
• heading is injected via dangerouslySetInnerHTML, and <strong> inside it is styled bold and colored with text-primary.
• The Next button is gated by per-step validation: service requires a selection, schedule requires both a date and a time slot, contact requires non-empty trimmed name and email (phone and notes are optional), and review always passes; the Back button is disabled on the first step.
• The 7 date buttons are generated at render from new Date() (today plus the next six days via addDays), independent of timeSlots; the first is labelled with todayLabel and the strip scrolls horizontally with its scrollbar hidden.
• service initializes to services[0]?.value, so the first service is preselected, while dateIndex and timeSlot start null and must be chosen before advancing past the schedule step.
• The progress bar width and the percentage badge are both derived from ((currentStep + 1) / steps.length) * 100; completed dots turn emerald with a check icon, the active dot uses the primary color, and the footer total block only appears on the final step when a service is active.
• stepCounterTemplate is rendered by string-replacing {current} and {total}, and price display concatenates currency directly in front of the raw price number with no locale or thousands formatting.