Share Referral Code via Native Share Sheet
Peer mentors communicate with prospective members through many different channels — some prefer SMS, others WhatsApp, email, or even social media. This story enables one-tap sharing of a pre-composed recruitment message that includes the peer mentor's referral code and a deep link to download the app. The share sheet should be triggered from the referral code screen and pre-populate a human-readable message in Norwegian that the peer mentor can optionally edit before sending. The deep link should direct the new member to the correct app store and pre-fill the referral code during onboarding.
User Story
Acceptance Criteria
- Given a peer mentor taps the share button on the referral code screen, when the native share sheet appears, then it contains a pre-composed message in Norwegian that includes the referral code and an app download deep link
- Given the pre-composed message is displayed in the share sheet, when the peer mentor selects a messaging app (SMS, WhatsApp, email), then the message is pre-filled in that app ready to send
- Given a prospective member taps the deep link from a shared message, when they open the app store or app, then the referral code is automatically attributed to the correct peer mentor without manual entry
- Given a peer mentor shares via the share sheet, when the share action completes, then the event is logged for attribution tracking purposes
- Given the share sheet is invoked, when the message is generated, then the peer mentor's organization-specific terminology (e.g., 'likeperson' vs 'støtteperson') is used correctly based on org labels
Business Value
Frictionless sharing dramatically increases the likelihood that a peer mentor will actually recruit during a natural conversation. Pre-composed messages ensure correct branding, accurate deep links, and proper attribution tracking. This is especially important because recruitment volume is a key metric for organizational health and funding justification.
Components
- Referral Code Screen ui
- Share Sheet Bridge infrastructure
- Deep Link / OAuth Redirect Handler infrastructure
- Referral Code Service service
- Referral Attribution Service service
- Terminology-Aware Text Widget ui