# Onboarding Steps with Progress

> A onboarding steps with progress block.

A shadcn/ui block from the [@blocks-so](https://blocks.so) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/blocks-so/onboarding-03).

- Page, with a live preview: https://shadcn.exchange/r/blocks-so/onboarding-03
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/blocks-so/onboarding-03-light-b75e47cc3b639550.png
- Registry item: https://blocks.so/r/onboarding-03.json
- Categories: onboarding
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://blocks.so/r/onboarding-03.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: `@tabler/icons-react`
- Registry items: `progress`

## Files

### `content/components/onboarding/onboarding-03.tsx`

```tsx
'use client';

import { IconCircleCheckFilled } from '@tabler/icons-react';
import { useState } from 'react';
import { Progress } from '@/components/ui/progress';
import { cn } from '@/lib/utils';

const steps = [
  {
    id: '1.',
    title: 'Create your store',
    description:
      "Choose a name, pick a subdomain, and configure your store's basic settings.",
  },
  {
    id: '2.',
    title: 'Add your products',
    description:
      'Upload your catalog with photos, pricing, and inventory details.',
  },
  {
    id: '3.',
    title: 'Set up payments',
    description:
      'Connect Stripe or PayPal to start accepting orders from customers.',
  },
  {
    id: '4.',
    title: 'Launch your store',
    description: 'Review everything and publish your storefront to the world.',
  },
];

export function Onboarding03() {
  const [activeStep, setActiveStep] = useState(0);

  return (
    <div className="flex min-h-dvh items-center justify-center bg-background p-4">
      <div className="sm:mx-auto sm:max-w-lg">
        <h3 className="font-semibold text-foreground text-lg">Store setup</h3>
        <p className="mt-1 text-muted-foreground text-sm leading-6">
          Complete each step to launch your online store.
        </p>
        <div className="mt-4 flex items-center justify-end space-x-4">
          <span className="text-muted-foreground text-sm">
            Step {activeStep + 1}/{steps.length}
          </span>
          <Progress
            className="w-32"
            value={(activeStep / steps.length) * 100}
          />
        </div>
        <ul className="mt-4 space-y-4">
          {steps.map((step, index) => (
            <li key={step.id}>
              <button
                className={cn(
                  'relative w-full cursor-pointer rounded-lg border bg-card p-4 text-left focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2',
                  index === activeStep
                    ? 'border-foreground/20'
                    : 'border-border'
                )}
                onClick={() => setActiveStep(index)}
                type="button"
              >
                <div className="flex items-start space-x-3">
                  {index < activeStep ? (
                    <IconCircleCheckFilled
                      aria-hidden={true}
                      className="size-6 shrink-0 text-foreground"
                    />
                  ) : (
                    <span
                      aria-hidden={true}
                      className="flex size-6 items-center justify-center font-medium text-muted-foreground"
                    >
                      {step.id}
                    </span>
                  )}
                  <div>
                    <h3
                      className={cn(
                        'font-medium',
                        index < activeStep
                          ? 'text-muted-foreground line-through'
                          : 'text-foreground'
                      )}
                    >
                      {step.title}
                    </h3>
                    <p className="mt-1 text-muted-foreground text-sm leading-6">
                      {step.description}
                    </p>
                  </div>
                </div>
              </button>
            </li>
          ))}
        </ul>
        <div className="mt-6 rounded-lg bg-muted p-4">
          <h4 className="font-medium text-foreground text-sm">Need help?</h4>
          <p className="mt-1 text-muted-foreground text-sm">
            Connect with a member of our team at{' '}
            <a
              className="font-medium text-primary"
              href="mailto:help@example.com"
            >
              help@example.com
            </a>
            .
          </p>
        </div>
      </div>
    </div>
  );
}
```