Accordion Steps with Expandable Actions

Onboarding10: Accordion Steps with Expandable Actions

Accordion-style setup guide: each step is a collapsible panel with its own indicator, title, description, and caller-supplied action content, with the first step expanded by default. Completion status and expand/collapse state are two entirely separate mechanisms.

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

Base UI flavor

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

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

Quick start

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

import { Onboarding10, onboarding10Demo } from "@/components/beste/block/onboarding10";

export default function OnboardingPage() {
  return <Onboarding10 {...onboarding10Demo} />;
}

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

import { Onboarding10 } from "@/components/beste/block/onboarding10";
import { Button } from "@/components/ui/button";

export default function OnboardingPage() {
  return (
    <Onboarding10
      badge={{ label: "Setup Guide", variant: "secondary" }}
      heading="Complete your setup"
      description="Expand each step to learn more and complete the action."
      steps={[
        {
          id: "1",
          title: "Create your profile",
          description: "Add your personal information",
          content: <Button size="sm">Edit Profile</Button>,
        },
        {
          id: "2",
          title: "Connect your calendar",
          description: "Sync your schedule",
          content: <Button size="sm">Connect Calendar</Button>,
        },
      ]}
      completedSteps={["1"]}
      primaryButton={{ label: "Continue to Dashboard", href: "/dashboard" }}
    />
  );
}

Props

type AccordionStep = {
  id: string;
  title: string;
  description?: string;
  content: React.ReactNode;
};

Behavior notes

• Only one piece of interactive state exists: openSteps, initialized to [steps[0]?.id ?? ""] so the first step starts expanded. Toggling a step (toggleStep) purely opens or closes its panel; nothing about "completed" status is touched by this interaction.
• completedSteps is a plain array of step ids supplied via props; there is no click handler that adds an id to it, so marking a step done requires the parent to update the prop, for example after the user finishes whatever action button lives inside that step's content.
• The "X of Y completed" count in the header is derived directly from completedSteps.length versus steps.length, independent of which panels are currently expanded.
• Each step's action button (e.g. "Edit Profile", "Connect Calendar") lives inside the caller-supplied content node and is purely decorative in the shipped demo; there's no prop wiring those buttons back into the component's own state.
• primaryButton renders as a plain <a> tag wrapped in Button asChild, unlike the next/link Link used for CTAs in most other blocks in this family.
• If steps is empty the component returns null rather than rendering an empty shell.