Achievement Badges & Status Recognition
Feature Detail
Description
A badge system that awards peer mentors visible recognition for reaching activity milestones, completing training, maintaining streaks, or achieving organisational thresholds (e.g., Blindeforbundet's 3rd and 15th assignment triggering different honorar rates). Badges are displayed on the peer mentor's profile and visible to coordinators. Beyond individual badges, the system includes named recognition tiers such as 'ร rets koordinator' (Coordinator of the Year) and seasonal awards. This creates healthy social recognition without competitive ranking, acknowledging contribution quality and consistency rather than volume alone.
Analysis
Provides low-cost, high-impact recognition that supplements or replaces physical awards. Particularly valuable for Blindeforbundet where assignment count already drives financial thresholds โ surfacing these counts as badges aligns gamification with existing business rules.
Define badge taxonomy per organisation (badges are configurable, not hardcoded). Store earned badges in Supabase with earned_at timestamps. Badge criteria evaluated server-side via Supabase Edge Functions triggered on activity save. UI: badge shelf on profile screen with locked/unlocked states. Ensure badge icons meet contrast requirements and include text labels for screen reader users.
Components (213)
Shared Components
These components are reused across multiple features
User Interface (59)
Service Layer (52)
Data Layer (33)
Infrastructure (54)
User Stories (7)
As a As a Peer Mentor (Likeperson)
I want to see which recognition tier I currently hold and how close I am to the next tier
So that I have a clear long-term goal to work towards and understand my standing within the peer mentor community
- Given I am on my stats or profile screen, When the screen loads, Then I see a recognition tier banner displaying my current tier name and icon
- Given I am not yet at the highest tier, When I view the tier banner, Then I see a progress indicator showing the metric required for the next tier and my current progress towards it
- Given I have reached the highest tier, When I view the tier banner, Then I see a 'Maximum tier reached' message and the banner reflects this status
- +2 more
As a As a Peer Mentor (Likeperson)
I want to see a celebration overlay with animation the moment I earn a new badge
So that I feel an immediate sense of achievement and emotional reward for reaching a milestone
- Given I have just completed an activity that crosses a badge threshold, When the app processes the activity, Then the badge-earned celebration overlay appears within 2 seconds
- Given the celebration overlay is visible, When I tap anywhere or press the close button, Then the overlay dismisses and I return to the previous screen
- Given I use a screen reader, When the celebration overlay appears, Then the badge name and achievement description are announced automatically via live region
- +2 more
As a As a Peer Mentor (Likeperson)
I want to receive a push notification on my device when I earn a new achievement badge
So that I am informed of my achievement even when the app is not open, reinforcing the positive recognition in a timely way
- Given I have push notifications enabled, When the system awards me a new badge, Then I receive a push notification within 5 minutes of the badge being awarded
- Given I receive the badge push notification, When I tap it, Then the app opens directly to my badge shelf with the newly earned badge visually highlighted
- Given I have disabled badge notifications in settings, When a badge is awarded to me, Then I do not receive a push notification but still see the badge in the app
- +2 more
As a As a Peer Mentor (Likeperson)
I want to see a summary of the badges I earned during the year as part of my annual wrapped summary
So that I can reflect on my year of achievement in a shareable, celebratory format that makes my contributions visible
- Given I open my annual wrapped summary, When the summary screen loads, Then I see a badge section listing all badges I earned during that year with icons and names
- Given I earned no badges in the selected year, When the badge section renders, Then it displays an encouraging message such as 'Keep going โ your first badge is within reach'
- Given the wrapped summary is displayed, When I identify the most significant badge, Then a milestone badge widget shows that badge prominently with a larger icon and descriptive text
- +2 more
As a As a Peer Mentor (Likeperson)
I want to browse all available badges and read the specific criteria required to earn each one
So that I can plan my activities strategically and understand what milestones the organisation values
- Given I tap on a locked badge card, When the detail modal opens, Then I see the badge name, a plain-language description of the criteria, and my current progress if measurable
- Given I tap on an earned badge card, When the detail modal opens, Then I see the date I earned the badge and a congratulatory message alongside the criteria
- Given a badge has multiple criteria, When the detail modal is displayed, Then all criteria are listed as individual checklist items with a checkmark indicating completion status
- +2 more
As a As a Peer Mentor (Likeperson)
I want to navigate and interact with the badge shelf and badge details using only a screen reader
So that I can benefit from the recognition system regardless of whether I have a visual impairment, ensuring the feature is fully inclusive
- Given I navigate the badge shelf with VoiceOver enabled, When I focus on a badge card, Then the screen reader announces '[Badge Name], earned on [Date]' or '[Badge Name], locked โ [progress description]'
- Given I open the badge detail modal with a screen reader, When the modal appears, Then focus is automatically moved to the modal heading and the close button is reachable via a single swipe
- Given I dismiss the badge detail modal, When the modal closes, Then focus returns to the badge card that triggered the modal open
- +2 more
As a As a Peer Mentor (Likeperson)
I want to view all the achievement badges I have earned displayed on a dedicated badge shelf
So that I can see a visual summary of my accomplishments and feel recognised for my volunteer contributions
- Given I am on the home screen, When I navigate to my profile or badge section, Then I see the badge shelf widget listing all earned badges with icons and names
- Given I have earned at least one badge, When the badge shelf loads, Then badges are displayed in the correct earned order with the most recent badge shown first
- Given I tap a badge card, When the detail modal opens, Then I see the badge name, description, criteria that unlocked it, and the date it was awarded
- +2 more