# Application Integration: Integration Setup Wizard

A guided setup wizard with a vertical step rail beside a pane of sync direction cards, a conflict rule note, and Back and Continue actions.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-setup-wizard
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Integrations](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-setup-wizard.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-integrations-integration-setup-wizard
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: badge, button
- Installs to: `@/components/blocks/application-pro/integrations/integration-setup-wizard`

## About this block

Integration Setup Wizard is the guided connect flow
for a HubSpot integration: a vertical step rail on the
left marking Connect account as done, Choose sync
direction as the active step, and Map fields and Review
as upcoming, beside a content pane where the sync
direction is picked from three radio style cards. The
recommended two way card carries a conflict rule note
on which edit wins, and the footer shows Step 2 of 4
with Back and Continue actions.

Steps and directions are two const arrays, steps with
name, detail, and state fields and directions with
name, description, note, recommended, and selected
fields. The conflict rule note is the detail that
matters: it says the most recent edit wins and the
older value is kept in history, so two way sync never
silently loses a change.

## When to use

Reach for this block on an integration setup page or a
first run onboarding flow, wired to your connector and
sync API. Show it right after a user signs in to the
source so they choose how data flows before any records
move.

A natural flow around it on an Application Pro page:

**Before**

- [Connected accounts list](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations)
- [Onboarding](https://www.shadcn-ui-blocks.com/blocks/application-pro/onboarding)

**After**

- [Field mapping panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations)
- [Settings pages](https://www.shadcn-ui-blocks.com/blocks/application-pro/settings-pages)

## What you can display

One strong use is the CRM sync direction step. Other
setup wizards:

- **Data warehouse connector.** Pick a sync schedule
  and a write mode with a backfill estimate per option.
- **Payment provider.** Choose which events to receive
  with a signing secret shown once on the final step.
- **Calendar sync.** Select which calendars flow in
  each direction with a busy only privacy option.

> Tip: name the conflict rule on any two way sync; a
> card that hides which edit wins turns every overlap
> into a support ticket.

## More in Application Integrations

- [Api Explorer Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/api-explorer-panel)
- [API Keys Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/api-keys-panel)
- [Api Usage Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/api-usage-card)
- [API Version Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/api-version-panel)
- [Connected Accounts List](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/connected-accounts-list)
- [Connected Services Status](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/connected-services-status)
- [Field Mapping Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/field-mapping-panel)
- [Github Repo Picker](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/github-repo-picker)
- [Incoming Webhook Setup](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/incoming-webhook-setup)
- [Integration Detail Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-detail-panel)
- [Integration Health Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-health-card)
- [Integration Logs Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-logs-table)
- [Integration Marketplace](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-marketplace)
- [Integration Request Board](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integration-request-board)
- [Integrations Gallery](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/integrations-gallery)
- [IP Allowlist Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/ip-allowlist-panel)
- [Oauth Consent Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/oauth-consent-blueprint)
- [Oauth Scopes Review](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/oauth-scopes-review)
- [Rate Limit Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/rate-limit-card)
- [SDK Quickstart Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/sdk-quickstart-panel)
- [Slack Connect Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/slack-connect-panel)
- [Sync Conflict Resolver](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/sync-conflict-resolver)
- [Sync Dry Run Preview](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/sync-dry-run-preview)
- [Sync Status Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/sync-status-panel)
- [Webhook Settings Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/webhook-settings-panel)
- [Webhook Test Console](https://www.shadcn-ui-blocks.com/blocks/application-pro/integrations/webhook-test-console)
