Share Referral Link via Native Share Sheet
The Referral Link Widget exposes a share action that triggers Flutter's Share plugin, surfacing the native iOS or Android share sheet. The peer mentor selects their preferred channel from the share sheet and the referral link is inserted into the message body automatically. No copy-paste is required. This zero-friction sharing mechanism is essential for a volunteer peer mentor who may want to quickly forward a link during a conversation without switching apps.
User Story
Acceptance Criteria
- Given the peer mentor is on the recruitment screen with their referral link visible, when they tap the share button, then the native platform share sheet appears (iOS share sheet on iPhone, Android share sheet on Android)
- Given the native share sheet is open, when the peer mentor selects a channel (e.g. WhatsApp, SMS, email), then the referral link is pre-populated in the message field
- Given the peer mentor completes a share action, when they return to the recruitment screen, then the share was treated as a non-blocking action and the screen is still intact
- Given the share sheet is triggered, when the device is offline, then the link is still shareable (the link itself is pre-generated and does not require a live network call at share time)
Business Value
Reducing the number of steps to share a referral link directly impacts how many peer mentors actually use the feature. Using the native share sheet means the feature works with every existing communication app on the device, eliminating the need to build integrations for individual channels. For HLF's goal of turning the app into a membership growth engine, frictionless sharing is the single most important UX factor.
Components
- Referral Link Widget ui
- Recruitment Service service