Repository navigation
Onboarding Identity Verification Wizard with Progressive Disclosure #33
Description
Description
This issue aims to address the implementation of Onboarding Identity Verification Wizard with Progressive Disclosure.
The core objective is to: Guide new users through a progressive identity verification wizard with step validation, save-and-resume, and clear error recovery.
By completing this feature, we will ensure that the GuildWorkman protocol maintains its high standards for security, usability, and decentralized logic. This issue requires careful attention to the Frontend architecture and adherence to the existing project conventions.
When picking up this issue, please ensure you document any new dependencies or architectural decisions made during development.
Component
Frontend
Difficulty
🔴 Hard
Tasks
- Review Next.js App Router structure
- Implement the UI components for: Onboarding Identity Verification Wizard with Progressive Disclosure
- Ensure responsive design using Tailwind CSS or standard modules
- Add caching for npm dependencies in CI
- Run
npm run lintandnpm run typecheck - Run
npm run buildto verify production bundling
Acceptance Criteria
- Feature accurately implements the objective: Guide new users through a progressive identity verification wizard with step validation, save-and-resume, and clear error recovery.
- Any PR that introduces TypeScript errors is automatically blocked
- CI pipeline runs in under 3 minutes per PR
- Code is properly reviewed and approved by codeowners
Estimated Time
1-3 days
Activity
Endowed992 commentedon Jul 21, 2026
Hello, can i be assigned to this issue?
Promise278 commentedon Jul 21, 2026
I have experience with system design and architecture I would like to work on these please
Yourbigmike commentedon Jul 21, 2026
i would like to work on this issue as a full stack developer
DSOTec commentedon Jul 22, 2026
Hi maintainer, I'd like to take this. An identity verification wizard is the first real touchpoint for new users — progressive disclosure, save-and-resume, and clear error recovery aren't nice-to-haves here, they're what determines whether users complete onboarding or drop off.
Key design decisions:
State: Typed reducer with explicit step transitions, Zod validation per step, partial data persisted per step for save-and-resume. Resume check runs server-side to avoid flashing the initial step.
Progressive disclosure: Step N+1 only rendered after step N validates — never mounted in advance. Smooth transition between steps to reinforce sequential flow.
Save-and-resume: Persist on every validated step completion (backend or localStorage fallback), offer "Continue where you left off" on return. Not just on final submit.
Error recovery: Per-field inline validation on blur, per-step on "Next" attempt. Specific actionable errors at both client and backend verification failure points with clear retry paths.
Responsive: Mobile-first, sticky progress indicator, fixed action buttons on mobile. Tailwind CSS, consistent with existing conventions.
I'll review the codebase first to confirm the exact verification steps and adapt accordingly. New dependencies and architectural decisions documented in the PR description.
grantfox-oss commentedon Jul 22, 2026
🦊 GrantFox — @DSOTec has been assigned to this issue as part of the Official Campaign | FWC26 campaign!
Next steps:
Closes #33)Good luck! Track your progress on GrantFox.
grantfox-oss commentedon Jul 27, 2026
🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign | FWC26 campaign!
@DSOTec's PR #36 was approved and merged by @meshackyaro.
🏆 @DSOTec: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (517 total points). Track your full progress on GrantFox.
👏 Great work, @DSOTec! Keep contributing to workman-labs.