Step Player, animated React component

An onboarding player: the current step's dot stretches into a bar that fills while it plays, then eases over to the next dot as a small wave runs through the ones ahead. Play, pause, or tap a dot to jump to a step.

Pro
Inputs & Controls
Spring

Play with it

Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.

Step 1 of 4

Connect your calendar

We only read busy times, never the details.

Props

Prop	Type	Default	What it does
accent	string	"#0071e3"	Colour of the filling bar, finished dots and the "Step n of m" line.
steps	StepPlayerStep[]	DEFAULT_STEPS	Steps to play through, each { t: title, b: one-line body }.
stepDuration	number	3.2	Seconds each step plays before moving on.
autoplay	boolean	true	Starts playing on mount. Set to false to start paused; the play button still works.

Add it to your project

Prepare your project

You need Tailwind CSS and the @/import alias. If shadcn isn't set up yet, initialise it once:

npx shadcn@latest init

Then add the Nexus registry to your components.json (the registries key is the part that matters):

{
  "$schema": "https://ui.shadcn.com/schema.json",
  "style": "default",
  "rsc": true,
  "tsx": true,
  "tailwind": {
    "css": "src/app/globals.css",
    "baseColor": "neutral",
    "cssVariables": true,
    "prefix": ""
  },
  "aliases": {
    "components": "@/components",
    "utils": "@/lib/utils",
    "ui": "@/components/ui",
    "lib": "@/lib",
    "hooks": "@/hooks"
  },
  "registries": {
    "@nexus-labs": "https://www.nexus-ui.com/api/registry/{name}"
  }
}

2
Add the component
Run this from your project root. It adds the component, the utilities it uses and its packages.
```
npx shadcn@latest add @nexus-labs/step-player
```
3
Check what was added
With the standard aliases, these files land in your project:
components/
step-player/
index.ts
step-player.tsx
4
Copying by hand? Install the packages
Skip this if you used the command above.
```
npm install framer-motion
```

Use it in a page

Import it and render it. The Code tab above has the full example.

// app/page.tsx
import { StepPlayer } from "@/components/step-player";

export default function Page() {
  return (
    <main>
      <StepPlayer />
    </main>
  );
}

StepStep Player, animated React component

Play with it

Props

More inputs & controls

Step Player, animated React component