# Feature Wizard

> A guided, multi step layout that reveals features as the visitor advances. Useful for onboarding copy or walking through a setup flow one screen at a time.

A shadcn/ui block from the [@shadcn-ui-blocks](https://www.shadcn-ui-blocks.com) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/shadcn-ui-blocks/marketing-feature-sections-feature-wizard).

- Page, with a live preview: https://shadcn.exchange/r/shadcn-ui-blocks/marketing-feature-sections-feature-wizard
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/shadcn-ui-blocks/marketing-feature-sections-feature-wizard-light-420a1f8132fafaad.png
- Registry item: https://www.shadcn-ui-blocks.com/r/marketing-feature-sections-feature-wizard.json
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://www.shadcn-ui-blocks.com/r/marketing-feature-sections-feature-wizard.json
```

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

## Dependencies

- npm packages: `class-variance-authority`, `lucide-react`, `radix-ui`

## Files

### `components/blocks/marketing/feature-sections/feature-wizard.tsx`

```tsx
import { useState } from 'react';
import { Button } from '@/components/ui/button';
import {
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from '@/components/ui/card';
import { Badge } from '@/components/ui/badge';
import { Progress } from '@/components/ui/progress';
import { ChevronLeft, ChevronRight, CheckCircle2, Star, MousePointerClick, BarChart4, Lightbulb, RotateCcw, ArrowRight, Database } from 'lucide-react';

import { cn } from '@/lib/utils';

import type { ComponentType, SVGProps } from 'react';

type LucideIcon = ComponentType<SVGProps<SVGSVGElement> & { size?: number | string }>;
interface Feature {
  id: string;
  title: string;
  shortDescription: string;
  fullDescription: string;
  icon: LucideIcon;
  benefits: string[];
  image: string;
  cta: {
    text: string;
    href: string;
  };
  color: string;
}

const features: Feature[] = [
  {
    id: 'analytics',
    title: 'Advanced Analytics',
    shortDescription: 'Powerful data insights',
    fullDescription:
      'Our advanced analytics platform provides real-time insights into your business performance, enabling data-driven decisions with custom dashboards, alerts, and reports.',
    icon: BarChart4,
    benefits: [
      'Real-time performance dashboards',
      'Custom reporting tools',
      'Predictive analytics',
      'Data visualization',
    ],
    image:
      'https://images.unsplash.com/photo-1551288049-bebda4e38f71?q=80&w=1000&auto=format&fit=crop',
    cta: {
      text: 'See analytics in action',
      href: '#',
    },
    color: 'bg-blue-500/10 text-blue-600',
  },
  {
    id: 'automation',
    title: 'Workflow Automation',
    shortDescription: 'Automate repetitive tasks',
    fullDescription:
      'Build powerful automation workflows that save time and reduce errors. Connect your tools and processes with our visual automation builder.',
    icon: RotateCcw,
    benefits: [
      'Visual workflow builder',
      'Trigger-based automations',
      'Cross-platform integration',
      'Error handling and recovery',
    ],
    image:
      'https://images.unsplash.com/photo-1485827404703-89b55fcc595e?q=80&w=1000&auto=format&fit=crop',
    cta: {
      text: 'Start automating',
      href: '#',
    },
    color: 'bg-amber-500/10 text-amber-600',
  },
  {
    id: 'ai',
    title: 'AI Recommendations',
    shortDescription: 'Smart suggestions',
    fullDescription:
      'Leverage the power of artificial intelligence to receive personalized recommendations, predict outcomes, and optimize your business operations.',
    icon: Lightbulb,
    benefits: [
      'Personalized insights',
      'Predictive recommendations',
      'Anomaly detection',
      'Decision support',
    ],
    image:
      'https://images.unsplash.com/photo-1526378722484-bd91ca387e72?q=80&w=1000&auto=format&fit=crop',
    cta: {
      text: 'Explore AI features',
      href: '#',
    },
    color: 'bg-purple-500/10 text-purple-600',
  },
  {
    id: 'ux',
    title: 'User Experience',
    shortDescription: 'Intuitive interfaces',
    fullDescription:
      'Create delightful user experiences with our design tools and components. Build interfaces that users love with minimal effort.',
    icon: MousePointerClick,
    benefits: [
      'Drag-and-drop UI builder',
      'Responsive design templates',
      'User behavior analytics',
      'A/B testing capabilities',
    ],
    image:
      'https://images.unsplash.com/photo-1486312338219-ce68d2c6f44d?q=80&w=1000&auto=format&fit=crop',
    cta: {
      text: 'Design better UX',
      href: '#',
    },
    color: 'bg-green-500/10 text-green-600',
  },
  {
    id: 'data',
    title: 'Data Management',
    shortDescription: 'Organize your information',
    fullDescription:
      'Centralize and manage all your data with powerful organization tools, versioning, and secure sharing capabilities.',
    icon: Database,
    benefits: [
      'Unified data storage',
      'Automated backups',
      'Version control',
      'Robust search capabilities',
    ],
    image:
      'https://images.unsplash.com/photo-1544197150-b99a580bb7a8?q=80&w=1000&auto=format&fit=crop',
    cta: {
      text: 'Organize your data',
      href: '#',
    },
    color: 'bg-indigo-500/10 text-indigo-600',
  },
];

export default function FeatureWizard() {
  const [currentStep, setCurrentStep] = useState(0);
  const [completed, setCompleted] = useState<string[]>(['analytics']);
  const totalSteps = features.length;
  const progress = (currentStep / (totalSteps - 1)) * 100;

  const currentFeature = features[currentStep]!;

  const handleNext = () => {
    if (!completed.includes(currentFeature.id)) {
      setCompleted([...completed, currentFeature.id]);
    }

    if (currentStep < totalSteps - 1) {
      setCurrentStep(currentStep + 1);
    }
  };

  const handlePrevious = () => {
    if (currentStep > 0) {
      setCurrentStep(currentStep - 1);
    }
  };

  const handleStepClick = (index: number) => {
    if (!completed.includes(features[index]!.id)) {
      setCompleted([...completed, features[index]!.id]);
    }

    setCurrentStep(index);
  };

  const isFeatureCompleted = (id: string) => {
    return completed.includes(id);
  };

  return (
    <section className="container mx-auto space-y-12 px-4 py-24 md:px-6 2xl:max-w-[1400px]">
      <div className="space-y-4 text-center">
        <h2 className="text-3xl font-bold tracking-tighter sm:text-4xl md:text-5xl">
          Explore our platform features
        </h2>
        <p className="text-muted-foreground mx-auto max-w-[700px] md:text-xl/relaxed lg:text-base/relaxed xl:text-xl/relaxed">
          Take a guided tour through our key features and see how they can help
          your business
        </p>
      </div>

      {/* Wizard progress */}
      <div className="mx-auto w-full space-y-4 lg:max-w-3xl">
        <div className="flex items-center justify-between">
          <p className="text-sm font-medium">
            Step {currentStep + 1} of {totalSteps}
          </p>
          <Badge variant="outline">
            {completed.length} of {totalSteps} features explored
          </Badge>
        </div>

        <Progress value={progress} className="h-2" />

        <div className="flex flex-wrap justify-center gap-2">
          {features.map((feature, index) => (
            <Button
              key={feature.id}
              variant={index === currentStep ? 'default' : 'outline'}
              size="sm"
              className={cn(
                'gap-1 transition-all',
                isFeatureCompleted(feature.id) &&
                  index !== currentStep &&
                  'bg-primary/10'
              )}
              onClick={() => handleStepClick(index)}
            >
              {isFeatureCompleted(feature.id) && (
                <CheckCircle2 className="h-4 w-4 text-green-500" />
              )}
              <span>{feature.shortDescription}</span>
            </Button>
          ))}
        </div>
      </div>

      {/* Current feature */}
      <div className="grid grid-cols-1 items-center gap-8 lg:grid-cols-2">
        <div className="order-2 lg:order-1">
          <Card>
            <CardHeader className="space-y-1">
              <div className="flex items-start justify-between">
                <div className={cn('rounded-md p-2', currentFeature.color)}>
                  <currentFeature.icon className="h-6 w-6" />
                </div>
                {isFeatureCompleted(currentFeature.id) && (
                  <Badge
                    variant="outline"
                    className="flex items-center gap-1 text-green-600"
                  >
                    <CheckCircle2 className="h-3.5 w-3.5" />
                    Explored
                  </Badge>
                )}
              </div>
              <CardTitle className="text-2xl">{currentFeature.title}</CardTitle>
              <CardDescription className="text-base">
                {currentFeature.fullDescription}
              </CardDescription>
            </CardHeader>
            <CardContent className="space-y-4">
              <h4 className="flex items-center gap-2 font-medium">
                <Star className="h-4 w-4 text-amber-500" />
                Key Benefits
              </h4>
              <ul className="space-y-2">
                {currentFeature.benefits.map((benefit, i) => (
                  <li key={i} className="flex items-start gap-2">
                    <CheckCircle2 className="mt-0.5 h-5 w-5 flex-shrink-0 text-green-500" />
                    <span>{benefit}</span>
                  </li>
                ))}
              </ul>
            </CardContent>
            <CardFooter className="justify-between">
              <Button asChild variant="outline">
                <a href={currentFeature.cta.href}>{currentFeature.cta.text}</a>
              </Button>
              <div className="flex gap-2">
                <Button
                  variant="outline"
                  size="icon"
                  onClick={handlePrevious}
                  disabled={currentStep === 0}
                >
                  <ChevronLeft className="h-4 w-4" />
                </Button>
                <Button
                  variant="outline"
                  size="icon"
                  onClick={handleNext}
                  disabled={currentStep === totalSteps - 1}
                >
                  <ChevronRight className="h-4 w-4" />
                </Button>
              </div>
            </CardFooter>
          </Card>
        </div>

        <div className="relative order-1 min-h-[300px] overflow-hidden rounded-xl lg:order-2">
          <img
            src={currentFeature.image}
            alt={currentFeature.title}
            className="object-cover"
          />
          <div className="absolute inset-0 flex items-end bg-gradient-to-t from-black/60 to-transparent">
            <div className="p-6 text-white">
              <h3 className="text-xl font-bold">{currentFeature.title}</h3>
              <p className="text-white/80">{currentFeature.shortDescription}</p>
            </div>
          </div>
        </div>
      </div>

      {/* CTA section */}
      <div className="mt-16 flex flex-col items-center justify-between gap-8 rounded-xl border p-8 lg:flex-row">
        <div>
          <h3 className="text-xl font-bold">
            Ready to explore all our features?
          </h3>
          <p className="text-muted-foreground max-w-[600px]">
            See how our complete platform can transform your business with a
            personalized demo.
          </p>
        </div>
        <Button asChild size="lg">
          <a href="#">
            Schedule a demo <ArrowRight className="ml-2 h-4 w-4" />
          </a>
        </Button>
      </div>
    </section>
  );
}
```

### `components/ui/button.tsx`

```tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const buttonVariants = cva(
  "group/button inline-flex shrink-0 items-center justify-center rounded-md border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground hover:bg-primary/80",
        outline:
          "border-border bg-background shadow-xs hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
        secondary:
          "bg-secondary text-secondary-foreground hover:bg-secondary/80 aria-expanded:bg-secondary aria-expanded:text-secondary-foreground",
        ghost:
          "hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50",
        destructive:
          "bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40",
        link: "text-primary underline-offset-4 hover:underline",
      },
      size: {
        default:
          "h-9 gap-1.5 px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        xs: "h-6 gap-1 rounded-[min(var(--radius-md),8px)] px-2 text-xs in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3",
        sm: "h-8 gap-1 rounded-[min(var(--radius-md),10px)] px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5",
        lg: "h-10 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        icon: "size-9",
        "icon-xs":
          "size-6 rounded-[min(var(--radius-md),8px)] in-data-[slot=button-group]:rounded-md [&_svg:not([class*='size-'])]:size-3",
        "icon-sm":
          "size-8 rounded-[min(var(--radius-md),10px)] in-data-[slot=button-group]:rounded-md",
        "icon-lg": "size-10",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
)

function Button({
  className,
  variant = "default",
  size = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"button"> &
  VariantProps<typeof buttonVariants> & {
    asChild?: boolean
  }) {
  const Comp = asChild ? Slot.Root : "button"

  return (
    <Comp
      data-slot="button"
      data-variant={variant}
      data-size={size}
      className={cn(buttonVariants({ variant, size, className }))}
      {...props}
    />
  )
}

export { Button, buttonVariants }
```

### `components/ui/card.tsx`

```tsx
import * as React from "react"

import { cn } from "@/lib/utils"

function Card({
  className,
  size = "default",
  ...props
}: React.ComponentProps<"div"> & { size?: "default" | "sm" }) {
  return (
    <div
      data-slot="card"
      data-size={size}
      className={cn(
        "group/card flex flex-col gap-6 overflow-hidden rounded-xl bg-card py-6 text-sm text-card-foreground shadow-xs ring-1 ring-foreground/10 has-[>img:first-child]:pt-0 data-[size=sm]:gap-4 data-[size=sm]:py-4 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
        className
      )}
      {...props}
    />
  )
}

function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-header"
      className={cn(
        "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-6 group-data-[size=sm]/card:px-4 has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-6 group-data-[size=sm]/card:[.border-b]:pb-4",
        className
      )}
      {...props}
    />
  )
}

function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-title"
      className={cn(
        "font-heading text-base leading-normal font-medium group-data-[size=sm]/card:text-sm",
        className
      )}
      {...props}
    />
  )
}

function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-description"
      className={cn("text-sm text-muted-foreground", className)}
      {...props}
    />
  )
}

function CardAction({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-action"
      className={cn(
        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
        className
      )}
      {...props}
    />
  )
}

function CardContent({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-content"
      className={cn("px-6 group-data-[size=sm]/card:px-4", className)}
      {...props}
    />
  )
}

function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-footer"
      className={cn(
        "flex items-center rounded-b-xl px-6 group-data-[size=sm]/card:px-4 [.border-t]:pt-6 group-data-[size=sm]/card:[.border-t]:pt-4",
        className
      )}
      {...props}
    />
  )
}

export {
  Card,
  CardHeader,
  CardFooter,
  CardTitle,
  CardAction,
  CardDescription,
  CardContent,
}
```

### `components/ui/badge.tsx`

```tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const badgeVariants = cva(
  "group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-4xl border border-transparent px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&>svg]:pointer-events-none [&>svg]:size-3!",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
        secondary:
          "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
        destructive:
          "bg-destructive/10 text-destructive focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:focus-visible:ring-destructive/40 [a]:hover:bg-destructive/20",
        outline:
          "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
        ghost:
          "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
        link: "text-primary underline-offset-4 hover:underline",
      },
    },
    defaultVariants: {
      variant: "default",
    },
  }
)

function Badge({
  className,
  variant = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"span"> &
  VariantProps<typeof badgeVariants> & { asChild?: boolean }) {
  const Comp = asChild ? Slot.Root : "span"

  return (
    <Comp
      data-slot="badge"
      data-variant={variant}
      className={cn(badgeVariants({ variant }), className)}
      {...props}
    />
  )
}

export { Badge, badgeVariants }
```

### `components/ui/progress.tsx`

```tsx
"use client"

import * as React from "react"
import { Progress as ProgressPrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

function Progress({
  className,
  value,
  ...props
}: React.ComponentProps<typeof ProgressPrimitive.Root>) {
  return (
    <ProgressPrimitive.Root
      data-slot="progress"
      className={cn(
        "relative flex h-1.5 w-full items-center overflow-x-hidden rounded-full bg-muted",
        className
      )}
      {...props}
    >
      <ProgressPrimitive.Indicator
        data-slot="progress-indicator"
        className="size-full flex-1 bg-primary transition-all"
        style={{ transform: `translateX(-${100 - (value || 0)}%)` }}
      />
    </ProgressPrimitive.Root>
  )
}

export { Progress }
```