medium complexity extracted Referral Program Confidence: 100%
4
Components
4
Shared
0
User Stories
Yes
Analyzed

Description

This feature enables peer mentors to generate personalized invite links and QR codes that can be shared digitally or printed to recruit new members to their organization. The generated link or code uniquely identifies the referring peer mentor so that referrals can be attributed and tracked. Sharing can occur via native share sheets (WhatsApp, SMS, email) or by displaying the QR code on screen for in-person scanning. The feature supports the organization's member-growth objectives by turning every peer mentor into a lightweight recruiter without requiring manual coordination from administrators.

Sources & reasoning

Line 117 names vervefunksjonalitet as a unique HLF need. Line 164 of the priority matrix assigns it to Phase 3 with SHOULD priority for HLF only, and Norse Test. Phase 3 maps to v1.1 per the normalization rules. The blueprint area taxonomy (line 473) names Invite Link & QR Sharing as the first feature under referral-program, confirming this is one of the two canonical sub-features of the area.

  • docs/source/likeperson.md · line 117
    Vervefunksjonalitet for medlemsverving (appen som markedsført medlemsfordel).
  • docs/source/likeperson.md · line 164
    Verving / Referral (invite-link, rekruttering) | - | - | - | ✓ | ✓ | SHOULD (HLF) | 3
  • docs/source/likeperson.md · line 361
    Verving / Referral (HLF)

Analysis

Business Value

HLF explicitly identified recruitment as a strategic priority, framing the mobile app itself as a marketed membership benefit and a vehicle for peer-mentor-driven member growth. By embedding invite-link and QR-sharing directly in the app, the platform lowers the barrier for peer mentors to recruit contacts they interact with daily, turning organic in-person interactions into tracked referral events. This reduces the organization's reliance on centralized marketing campaigns and leverages the trust inherent in peer-mentor relationships. The QR code format is particularly relevant for in-person events and workshops where digital sharing is impractical, broadening reach beyond digitally fluent audiences.

Implementation Notes

Invite links should be short, unique URLs that encode a referral token tied to the generating peer mentor's user ID. The backend generates and persists the token; the mobile app fetches it on demand and hands it to the platform's native share sheet via Flutter's share_plus package. QR code rendering uses a client-side library (e.g. qr_flutter) so no server round-trip is needed for display. Deep-link handling on the registration flow must extract and validate the referral token and associate the new account with the referrer before token expiry. Token expiry, revocation, and reuse limits should be configurable per organization in admin settings. WCAG 2.2 AA requires that the QR code is supplemented with a copyable text link as a non-visual alternative.

User Stories

No user stories have been generated for this feature yet.