Invite Link & QR Sharing
Feature Detail
Description
This feature enables peer mentors and coordinators to share invitations to join their organization via personalized invite links and QR codes. Each generated link or code embeds a unique referral identifier that ties the prospective member back to the inviter and the organization, supporting the recruitment-as-marketed-benefit model HLF has championed. The feature includes share sheet integration on iOS and Android, deep-link handling that routes invitees to the appropriate onboarding flow, and a per-user invite history view so sharers can see which invitations are still outstanding.
Sources & reasoning
Listed verbatim in the canonical area taxonomy under referral-program, and motivated by HLF's stated need for app-as-marketed-membership-benefit recruitment functionality. Matrix row 114 places it in Phase 3, which maps to the Growth & Engagement phase name used in §5.
-
docs/source/likeperson.md · line 75Vervefunksjonalitet for medlemsverving (appen som markedsfÞrt medlemsfordel).
-
docs/source/likeperson.md · line 114Verving / Referral (invite-link, rekruttering) | - | - | - | â | â | SHOULD (HLF) | 3
-
docs/source/likeperson.md · line 362referral-program | Referral Program | Invite Link & QR Sharing, Recruitment Tracking
Analysis
HLF explicitly framed recruitment functionality as a strategic lever - the app itself becomes a marketed membership benefit, and existing members become a low-cost acquisition channel. Invite links and QR codes turn that intent into a concrete, low-friction action a peer mentor can take in seconds at a workshop, a stand, or a one-to-one conversation. For the organization, attributable invite identifiers mean recruitment becomes measurable for the first time, replacing anecdote with data. For the volunteer, sharing a personal link reinforces ownership of the program and feeds the broader "make invisible effort visible" theme that runs through the gamification and Wrapped features.
Invite tokens are generated server-side with a per-tenant signing key and persisted in the `referrals` table tied to the inviter's user_id and the organization_id; QR codes are rendered client-side from the resulting URL to avoid round-trips. Deep-link handling uses universal links on iOS and App Links on Android, with a web fallback page hosted on the Sales Website domain so invitees without the app installed are routed to install + onboard. The Invite Share Screen uses the platform share sheet rather than custom channel buttons, keeping the surface WCAG 2.2 AA compliant and aligned with the offline-first model - generation works offline, attribution is reconciled when the invitee actually signs up online.
Quality Assurance
Likeperson (primary) · Koordinator (same flow)Peer Mentor (Likeperson)
Quick UAT
- Logg inn i Meander-mobilappen som Likeperson og Äpne Hjem-fanen.
- Naviger til Verving â Del invitasjon for Ă„ Ă„pne Invite Share-skjermen.
- Bekreft at din personlige invitasjonslenke og QR-kode vises sammen med en tekst som forklarer at mottakeren knyttes til deg og din organisasjon.
- Trykk Del lenke og velg en mottaker i den native delingsmenyen (f.eks. SMS eller e-post).
- GĂ„ tilbake til skjermen, vis QR-koden i fullskjerm og skann den med et annet apparat.
- Bekreft at skanningen Äpner en pÄmeldingsflyt som viser riktig organisasjonsnavn og en bekreftelse pÄ at du er den som inviterer.
Quick UAT â Accessibility
-
Logg inn i Meander-mobilappen som Likeperson og Äpne Hjem-fanen.
- Screen reader Skjermleser annonserer 'Hjem, fane 1 av 5, valgt'.
- Focus visibility Synlig fokusring pÄ aktiv fane.
-
Naviger til Verving â Del invitasjon for Ă„ Ă„pne Invite Share-skjermen.
- Keyboard / focus Verving-menypunktet nÄs via Tab; Enter Äpner Del invitasjon.
- Touch target Menyvalg er minst 24Ă24 CSS px.
-
Bekreft at din personlige invitasjonslenke og QR-kode vises sammen med en tekst som forklarer at mottakeren knyttes til deg og din organisasjon.
- Screen reader Lenken leses opp som tekst, ikke tegn-for-tegn; QR-koden har alt-tekst 'QR-kode for din personlige invitasjon'.
- Contrast Forklaringsteksten har minst 4.5:1 kontrast mot bakgrunn.
-
Trykk Del lenke og velg en mottaker i den native delingsmenyen (f.eks. SMS eller e-post).
- Focus visibility Fokus flyttes til delingsmenyen nÄr den Äpnes og tilbake til Del-knappen nÄr den lukkes.
- Touch target Del-knappen er minst 24Ă24 CSS px.
-
GĂ„ tilbake til skjermen, vis QR-koden i fullskjerm og skann den med et annet apparat.
- Zoom QR-koden forblir skannbar ved 200 % systemzoom.
- Contrast QR-modulene har minst 4.5:1 kontrast mot bakgrunn.
-
Bekreft at skanningen Äpner en pÄmeldingsflyt som viser riktig organisasjonsnavn og en bekreftelse pÄ at du er den som inviterer.
- Live region 'Invitasjon validert. Du blir nÄ knyttet til <organisasjon> via <inviter>.'
Role Boundaries
3 role(s) must NOT access this feature-
Organization Administrator
Org Admin logger ikke inn i mobilappen som seg selv; invitasjonsdeling er ikke eksponert i admin-portalen. Deep-link til mobilskjermen fra admin-portalen returnerer 404/ikke-funnet.
-
Global Administrator
Global Admin har ingen mobiltilgang; API-kall for Ä hente en personlig invitasjonstoken pÄ vegne av en bruker returnerer 403.
-
Prospective Buyer
Salgsnettstedet eksponerer ingen invitasjonsdeling; det finnes ingen pÄlogging eller skjerm for dette. Ingen API tilgjengelig uten autentisering.
Expected End State
Mottakeren av invitasjonen lander i en pÄmeldingsflyt som er forhÄndsknyttet til riktig organisasjon, og redemptionen registreres i Invite Store med inviterens identitet slik at Recruitment Tracking kan attribuere vervingen.
Components (7)
Shared Components
These components are reused across multiple features
User Stories
No user stories have been generated for this feature yet.