Improve QR scanner feedback, recovery, and verification experience

[Lakes41]

Difficulty: Intermediate
Type: UI/UX

Background

GuildPass Mobile provides QR code scanning for Guild Pass verification. Event entry often depends on scanning being quick and reliable, yet scanner failures caused by poor lighting, invalid QR codes, camera permissions, or temporary network delays currently provide limited guidance to users.

Improving the verification experience will reduce failed scans and make the application more reliable during live events.

Problem

The scanner provides little feedback about why verification failed or how users can recover. In many cases users must manually retry the process without understanding whether the issue was caused by the camera, connectivity, or the QR code itself.

Expected outcome

Create a more resilient scanning experience that clearly communicates scanner status, verification progress, and failure reasons while minimizing unnecessary user interaction.

Suggested implementation

1. Categorize scanner failures (camera unavailable, permission denied, unreadable QR code, unsupported format, network timeout, verification failure).
2. Display contextual error messages with recovery guidance.
3. Add a verification loading state while server validation is in progress.
4. Automatically reset the scanner after recoverable failures instead of requiring users to reopen the scanning screen.
5. Improve camera permission handling and provide instructions when access has been permanently denied.
6. Add visual success and failure animations to improve user confidence during verification.

Acceptance criteria

• Invalid QR codes produce descriptive error messages.
• Camera permission failures include recovery instructions.
• Recoverable scan failures automatically restart scanning.
• Verification progress is clearly communicated.
• Existing successful verification behavior remains unchanged.

Likely affected files/directories

src/features/scanner/, src/components/, src/screens/, src/navigation/, src/hooks/

[OsejiFabian]

PLEASE I WOULD LIKE TO WORK ON THS ISSUE AND I WILL SUBMIT A GOOD AND QUALITY PR IN 24 HOURS

[grantfox-oss]

🦊 GrantFox — @OsejiFabian has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #213)
2. Your PR will be reviewed by the Adamantine-guild maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign | FWC26 campaign!

@OsejiFabian's PR #274 was approved and merged by @Lakes41.

🏆 @OsejiFabian: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (379 total points). Track your full progress on GrantFox.

👏 Great work, @OsejiFabian! Keep contributing to Adamantine-guild.