Understand the Criteria Required to Earn Each Badge
The badge detail modal, accessible from both earned and locked badge cards, explains exactly what a peer mentor must do to earn the badge. Criteria are expressed in plain language (e.g., 'Complete 25 individual sessions', 'Be active for 12 consecutive months'). Locked badges show progress where applicable (e.g., '17 of 25 sessions completed'). Badge definitions are managed by the organisation administrator and synced from the badge definition repository. The criteria are displayed with sufficient contrast and font size to meet WCAG 2.2 AA.
User Story
Acceptance Criteria
- 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
- Given the badge definition has been updated by an administrator, When I next view the badge detail modal, Then I see the updated criteria without needing to reinstall the app
- Given I use a screen reader, When I focus on a badge card, Then the screen reader announces the badge name and whether it is earned or locked
Business Value
Transparent badge criteria turn the recognition system into a coaching tool: peer mentors who understand what is valued will voluntarily align their behaviour with programme goals. This directly supports HLF and NHF's objective of increasing both the volume and quality of peer mentor activity without additional coordinator intervention.
Components
- Badge Detail Modal ui
- Badge Card Widget ui
- Badge Definition Repository data
- Badge Icon Asset Manager infrastructure
- Badge Configuration Service service
- Semantics Wrapper Widget ui