Template Starter Picker

Onboarding20: Template Starter Picker

Onboarding screen with a single-select grid of starter templates, each card carrying an icon, title, and optional tag ("Popular", "New"); picking a card is required before the primary CTA activates.

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

Base UI flavor

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

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

Quick start

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

import { Onboarding20, onboarding20Demo } from "@/components/beste/block/onboarding20";

export default function OnboardingPage() {
  return <Onboarding20 {...onboarding20Demo} />;
}

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

import { Layout, Presentation, Shapes, SquareKanban } from "lucide-react";
import { Onboarding20 } from "@/components/beste/block/onboarding20";

export default function OnboardingPage() {
  return (
    <Onboarding20
      badge={{ label: "Get Started", variant: "secondary" }}
      heading="Start with a template"
      description="Pick a template to get up and running quickly."
      templates={[
        { id: "blank", icon: <Shapes className="size-6" />, title: "Blank Project" },
        { id: "marketing", icon: <Presentation className="size-6" />, title: "Marketing Site", tag: "Popular" },
        { id: "dashboard", icon: <Layout className="size-6" />, title: "Dashboard" },
        { id: "kanban", icon: <SquareKanban className="size-6" />, title: "Kanban Board" },
      ]}
      primaryButton={{ label: "Create Project", href: "/project/new" }}
      secondaryButton={{ label: "Skip for now", href: "/dashboard" }}
    />
  );
}

Props

type Template = {
  id: string;
  icon: React.ReactNode;
  title: string;
  tag?: string;
};

Behavior notes

• Selection is single-choice: useState<string | null> holds at most one selected template id, unlike the multi-select Set pattern used by the goal and interest pickers elsewhere in this family.
• primaryButton stays disabled until a template is selected, then navigates via a manual window.location.href = primaryButton.href inside onClick, the same pattern used by the goal and interest pickers.
• A card's tag badge (e.g. "Popular", "New") is only shown while that card is unselected; selecting it swaps the tag out for a primary checkmark badge in the same top-right corner.
• The grid always shows 2 columns on mobile whenever templates.length is 3 or more, because the base layout class includes grid-cols-2 unconditionally before the sm:/lg:/md: breakpoints take over.
• labels.blankProject is declared in the props type but never referenced in the render; the "Blank Project" title comes from the template's own title field, not this label.