Vertical Timeline Steps

Onboarding6: Vertical Timeline Steps

Vertical timeline of setup steps: each row pairs a circular indicator (checkmark, icon, or number) with a title and description, connected by a vertical line down the left edge. Like its horizontal sibling, the block has no internal step state; currentStep is a plain number that only affects styling on each render.

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/onboarding6?email=YOUR_EMAIL&license_key=YOUR_KEY"

Base UI flavor

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

This installs the block to components/beste/block/onboarding6.tsx and the badge and button shadcn/ui primitives it depends on.

Quick start

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

import { Onboarding6, onboarding6Demo } from "@/components/beste/block/onboarding6";

export default function OnboardingPage() {
  return <Onboarding6 {...onboarding6Demo} />;
}

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

import { Onboarding6 } from "@/components/beste/block/onboarding6";

export default function OnboardingPage() {
  return (
    <Onboarding6
      badge={{ label: "Getting Started", variant: "secondary" }}
      heading="Set up your workspace"
      description="Complete these steps to start collaborating with your team."
      steps={[
        { id: "1", title: "Create your account", description: "Sign up with your work email." },
        { id: "2", title: "Invite team members", description: "Add colleagues to collaborate." },
        { id: "3", title: "Start collaborating", description: "You're all set." },
      ]}
      currentStep={1}
      primaryButton={{ label: "Continue Setup", href: "/setup/step-2" }}
      secondaryButton={{ label: "Skip for now", href: "/dashboard" }}
    />
  );
}

Props

type TimelineStep = {
  id: string;
  title: string;
  description?: string;
  icon?: LucideIcon;
};

Behavior notes

• No internal state (useState) exists in this file: currentStep is a plain number prop, so completed/current styling is a pure derivation on every render, and nothing inside the block advances or rewinds the timeline.
• step.icon overrides the numbered fallback for any step that is not yet completed, which means it renders for both the current step and every upcoming step; only once a step is marked completed (index < currentStep) does the checkmark take over from the icon.
• The vertical connector line for each row is absolutely positioned (absolute left-5 top-10 h-full) and only turns bg-primary when that row's step is completed; the last step in the list renders no connector at all.
• Row spacing uses pb-8 last:pb-0 on each step wrapper rather than a space-y utility on the container, so the connector line's height calculation lines up with the padding of each row.
• If steps is empty the component returns null rather than rendering an empty shell.
• Both buttons are plain links with no click handlers; advancing currentStep is entirely the responsibility of the page that renders this block.