Business users abandon setup because it feels like a dev tool. This is the design process behind an onboarding experience that collects technical configuration from non-technical users — without panic, confusion, or a call to IT.
I ran 5 unmoderated usability sessions with finance operations professionals using a competitor product. The abandonment moments were consistent and predictable — and entirely design-fixable.
| PRINCIPLE | HOW IT MANIFESTS |
|---|---|
| Orient before asking | Show all 5 steps in the sidebar before the user fills in a single field. The journey is visible from step 1. |
| AI does the hard part | AI pre-maps fields, auto-fills known endpoints, and validates before anything runs. User approves — doesn't configure. |
| No jargon on first pass | "API endpoint" becomes "Where does your data live?" Technical detail is available on expand, not in the primary flow. |
| Safety by default | Nothing runs until the final "Launch" step. AI confirms readiness. User can always go back. No destructive actions. |
| STEP | WHAT IT ASKS | WHY THIS POSITION | ANXIETY LEVEL |
|---|---|---|---|
| 1. Name | What do you want to call this integration? | Easiest possible first step. Success is instant. Confidence established. | None — anyone can name a thing |
| 2. Destination | Where should the data end up? | User selects from known destinations — no new concepts introduced. | Low — pick from a list |
| 3. Source | Where does your data live? | Visual picker replaces blank text. Most-used sources pre-configured. | Medium — mitigated by visual selection |
| 4. Field Mapping | Do these field names look right? | AI maps first; user confirms. Approval, not configuration. | Medium → Low after AI pre-fills |
| 5. Validate & Launch | Ready to go live? | AI runs a dry-run validation. User sees green checks before launch. | Low — AI confirms safety |
| STATE | INDICATOR | TITLE COLOR | DETAIL TEXT |
|---|---|---|---|
| Completed | Gold filled circle ✓ | Bright / white | Shows the value the user entered |
| Active | Gold outline circle | Gold highlight | "Current step" label |
| Future | Dim outline circle | Muted / 25% opacity | Brief description of what's coming |
This is the complete, interactive onboarding flow. Navigate through all 5 steps using the Continue button or click progress steps at the top. The sidebar updates live. Fill in fields, select a data source, and review the AI field mappings before launching.