# Screenshot Carousel Setup block

> Six-step workspace onboarding wizard with top progress bar and screenshot carousel rail

Multi-step signup flow: profile, role, source, workspace, goals, invites, with a top Stepper progress bar, animated stacked-screenshot rail, and a success state. ReUI Stepper, Badge; shadcn Field, Combobox, RadioGroup, Select, Switch.

- Type: Pro block
- Category: [Onboarding](https://web.dev.reui.io/blocks/application/onboarding.md)
- Page: https://web.dev.reui.io/blocks/application/onboarding/onboarding-7
- Docs (Base UI): https://web.dev.reui.io/docs/components/base/stepper.md
- Docs (Radix UI): https://web.dev.reui.io/docs/components/radix/stepper.md
- MCP: `get_block("onboarding-7")`
- Built with: Badge, Button, Checkbox, Combobox, Field, Icon Stack, Input, Item, Radio Group, Select, Spinner, Stepper, Switch
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

A stack of 3 light and dark image pairs rotating every 5.6 seconds beside the form, with Optional badges on the source and invite steps

## Agent notes

- `ONBOARDING_PREVIEW_MEDIA` holds 3 Unsplash light and dark pairs; swap in your screenshots sized to `PREVIEW_IMAGE_WIDTH` by `PREVIEW_IMAGE_HEIGHT`
- Keep `ONBOARDING_PREVIEW_MEDIA` at 3 or more pairs so each of the 3 `STACK_LAYERS` shows a different screenshot
- The `optional` flag on the source and invite entries of `ONBOARDING_STEPS` drives the Optional badge in `StepHeading`

## When not to use

- A plain centered form with no side imagery and an avatar upload on the profile step: use [Centered Setup Flow](https://web.dev.reui.io/blocks/application/onboarding/onboarding-4.md) (`get_block("onboarding-4")`)
- The side pane should echo the entered name, role and team size live: use [Live Preview Wizard](https://web.dev.reui.io/blocks/application/onboarding/onboarding-1.md) (`get_block("onboarding-1")`)

## Third-party libraries

- Motion v12: [API reference](https://motion.dev/docs/react-motion-component), [docs](https://motion.dev/docs/react) (the docs follow the latest Motion, with no React API break since v12)

## Install

```bash
npx shadcn@latest add @reui/onboarding-7
```

## About Onboarding blocks

### When to use

- A first-run setup after signup that collects profile, role, team size, goals and teammate invites
- Workspace creation shown as a full page, beside a product preview or in a modal over the app
- Developer tool signups that end by picking a coding agent and copying its CLI install commands

### When not to use

- A multi-step business task such as billing, vendor intake, a product listing or a transfer: use the [Wizard blocks](https://web.dev.reui.io/blocks/application/wizard.md)
- Only a progress indicator to place above step content you already built: use [Stepper](https://web.dev.reui.io/components/stepper.md) (`get_component("stepper")`)
- A purchase flow with shipping, payment and an order summary beside the steps: use the [Checkout blocks](https://web.dev.reui.io/blocks/ecommerce/checkout.md)

### Agent notes

- `completeOnboarding` only waits on a `window.setTimeout` before the ready screen; post the collected answers to your API there
- Replace `ONBOARDING_STEPS`, `ROLE_OPTIONS`, `GOAL_OPTIONS` and `DEFAULT_INVITES` in data.tsx; the step order and titles come from `ONBOARDING_STEPS`
- The timezone `Combobox` over `TIMEZONE_GROUPS` takes no `value` or `onValueChange`, so the picked zone never reaches component state

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.