Blog: Why Your Onboarding Checklist Shouldn't Vanish When You're Done
Why Your Onboarding Checklist Shouldn't Vanish When You're Done
Release v0.1.369 · UI/UX · Usability
When a user completes every step of an onboarding checklist, it feels like a win — and it should. But what happens the moment after they dismiss the celebration banner? In the current implementation of the OnboardingChecklist component, the answer is: nothing. The component hides itself completely, and there is no way back.
This release surfaces that gap and charts the path to fixing it.
What the Checklist Does Today
The OnboardingChecklist component guides new users through 5 setup steps. It has two visible states:
| State | When it appears |
|---|---|
| Expanded checklist | While steps remain incomplete |
Collapsed ribbon (allDismissed) | Only if the user manually dismisses the checklist before completing all steps — shows a BookOpen Getting Started X/5 complete link |
There is a third, unintended state:
| State | When it appears |
|---|---|
| Nothing | After all 5 steps are completed and the celebration banner is dismissed |
That third state is the problem.
Who Gets Hurt
The completing user
After finishing setup, a user may want to revisit a step — to double-check a configuration, share it with a colleague, or follow a link they skipped. Today, that path is gone.
New team members
If a team member joins an account where onboarding is already complete, they see no trace of the Getting Started guide. There is no breadcrumb, no link, no hint it ever existed. For a platform where landlords, agents, and tenants all interact with the same workspace, this is a real discovery failure.
The Fix
Two complementary changes are recommended:
1. Persistent Getting Started Guide link
After completion, the checklist's place in the UI should be taken by a low-footprint, permanent Getting Started Guide link — placed in the sidebar footer or Settings area, not the main dashboard. This keeps the dashboard clean for experienced users while ensuring the content is always one click away.
Sidebar footer
└── 📖 Getting Started Guide ← persistent, post-completion
This link serves both returning users who want a refresher and new team members who need to orient themselves independently.
2. One-time post-completion banner (7-day window)
Immediately after completion, show a dismissible banner for up to 7 days:
✅ You completed setup! Here's what to do next →
Analytics · Integrations · Inventory Templates
This banner acts as a natural handoff from onboarding into the platform's more advanced capabilities, without being intrusive — it's shown once and disappears after 7 days or on manual dismissal.
Why It Matters
Onboarding is not a single event — it's a reference. The moment a checklist is completed is often not the moment a user is ready to act on everything they've set up. Removing access to that guide at the exact moment users have "graduated" from it is a common but avoidable UX mistake.
The fix is small. The impact — especially for growing teams onboarding new members into an already-configured workspace — is significant.
Affected component: src/components/onboarding-checklist.tsx