low complexity medium priority could have v1.1 extracted Training & Certification Confidence: 100%
4
Components
58
Shared
0
User Stories
Yes
Analyzed

Description

This feature enables peer mentors to act as ambassadors for their organization by facilitating membership recruitment directly through the app. Peer mentors can share referral links or initiate recruitment flows for prospective members, with the app tracking referrals back to the originating peer mentor. HLF identified this as a way to leverage the app as a marketed membership benefit that incentivizes both recruitment and app adoption. The feature is intentionally lightweight at launch, focusing on referral tracking and a clear recruitment screen rather than a full CRM workflow.

User Flow

Membership Recruitment Feature user flow
Click to expand

Analysis

Business Value

HLF's strategic intent is for the app itself to serve as a membership benefit — something that makes being a peer mentor more attractive and organizationally supported. A built-in recruitment feature directly serves this goal by giving peer mentors a frictionless way to invite new members, with the organization gaining visibility into recruitment activity per peer mentor. Tracking referrals enables coordinators to recognize top recruiters, feeding into the gamification and recognition strategy for v2. From an acquisition perspective, peer-to-peer recruitment typically yields higher-quality, longer-retained members than broadcast campaigns, making this a high-ROI feature relative to its implementation complexity.

Implementation Notes

The feature requires a recruitment_referrals table linking referring users to outcomes. The Flutter recruitment screen presents a simple call-to-action with a shareable deep link or referral code generated per user. Link generation is handled server-side via a Next.js API route that creates a short-lived referral token. Attribution is recorded when the referred individual completes registration and selects the same organization. The screen also includes static content about membership benefits, sourced from the External Link Service and editable by admins via the organization labels system. No payment or dues collection is in scope; the feature covers awareness and referral tracking only. Push notification triggers for referral conversion confirmation are a v2 enhancement.

Dependencies

role-based-access-controlapp-settings-preferencesexternal-resource-links

Definition of Done

Recruitment screen renders with organization-specific content
Referral link generation works and is shareable via native share sheet
Referral attribution recorded correctly in database on new member registration
Coordinator can view recruitment activity per peer mentor in admin panel
Feature is gated to appropriate roles via role-based access control
Screen meets WCAG 2.2 AA compliance

Components (62)

User Interface (1)

Service Layer (1)

Data Layer (1)

Infrastructure (1)

Shared Components

These components are reused across multiple features

Infrastructure (20)

User Stories

No user stories have been generated for this feature yet.