π¦ΉββοΈUser onboarding
π Opening Chests & Claiming Rewards
Chests are at the heart of the BKINDNESS gamified experience. They encourage exploration, reward engagement, and strengthen partnerships with local businesses. This section explains how users interact with chests and redeem rewards, including how QR validation works.
π Chest Types & Map Interaction
Users explore a GPS-based map with different chest types:
β’ π‘ Common Chests β Accessible to all, small daily rewards.
β’ π΅ Business Chests β Located at partner business locations.
β’ π£ Event Chests β Special limited-time or sponsored experiences.
β’ π Secret Chests β Only visible after completing specific actions or challenges.
π‘ Each chest is geofenced and requires user proximity to interact.
π Opening a Chest
1. Approach the chest location
β’ Map updates based on GPS data.
β’ Once within interaction radius, chest becomes tappable.
2. Tap to Open
β’ Engaging animation plays (custom to chest type).
β’ A randomized reward system determines the outcome:
β’ π« Digital coupons
β’ π§© Collectible badges
β’ π§ XP / Progress boosts
β’ π Instant prizes (sponsored items, NFTs in future)
3. View Reward
β’ Results are shown in a dynamic pop-up card.
β’ Users can tap Save or Use Now if itβs redeemable.

π§Ύ Claiming Business Rewards via QR
Many chests are sponsored by businesses and offer real-world perks like discounts, gifts, or experiences. These require in-store verification.
Flow:
1. User opens a Business Chest.
2. Reward card contains a QR code and instructions.

3. User visits the location and shows the QR to the merchant.
4. Merchant scans the QR using the BKINDNESS business app or scanner.
5. Once verified:
β’ Reward status changes to βClaimedβ.
β’ User receives confirmation and XP.
β’ Business sees analytics on their dashboard.
β QRs are time-limited and single-use for security.
π Light & Dark Variants
β’ Every screen has full support for light and dark modes.
β’ Claim UI elements are designed with accessibility contrast in mind.
β’ Real-time theme toggle supported from system settings.

π§ UX Highlights
Feature Description
π Smart proximity check Prevents false openings or misuse
π§² Reward stack system Unclaimed rewards go into βBackpackβ for future use
π Expiration reminder Push notifications and visual countdown for time-limited rewards
πΈ Visual scanning cues Helps merchant easily scan QR even in low light
π Reward Security
β’ Rewards are tied to user ID & device.
β’ QR codes expire after a set window (configurable per campaign).
β’ Users cannot duplicate active QR codes.
π² Screens from Figma (suggested GitBook embeds)
Screen Title Suggested Placement
Chest Interaction (map view) Under Chest Types & Map
Chest Opening Animation Under Tap to Open
Reward Pop-Up Under View Reward
QR Code Interface Under Claiming Business Rewards
Backpack / Reward Inventory Under UX Highlights
Last updated