Flow — Pair partner

Summary

Onboarding sequence that turns a single-user install into a paired-couple household. This is the wedge-defining flow.

Audience

couple (first-time installer + invited partner)

Entry

Fresh app install → sign-up / sign-in (Clerk, phone OTP or Google/Apple)

Steps

#	Step	Surface	Notes
1	Welcome	surface-mobile-onboarding-welcome	"For the two of you." Value prop + skip-to-solo option (heavily discouraged)
2	Stage picker	surface-mobile-onboarding-stage-picker	Sets stage-pre-decision / trying / pregnancy+week / postpartum / parenting
3	Pair partner	surface-mobile-onboarding-pair-partner	Generate WhatsApp deep link. First user sees waiting state. Skip-for-now leads to surface-mobile-home-solo
4	Partner opens link	(system)	Second user installs app, follows deep link, auto-joins Household
5	Context quiz	surface-mobile-onboarding-context-quiz	Both partners answer 6–8 questions: region, dietary rules, spiritual context, joint-family involvement, IVF/natural, comm preferences
6	Ready	surface-mobile-onboarding-ready	Personalized summary: "Here's your journey. Trial starts now."
7	Home	surface-mobile-home-shared	First shared briefing generated

Exit

Both partners land on surface-mobile-home-shared with a 14-day trial started. Household is in the correct stage.

Escapes

• Skip pairing at step 3 → surface-mobile-home-solo. App runs in degraded mode; every home visit shows a soft "invite your partner" chip. After 14 days, chip becomes sharper.
• Partner doesn't join in 7 days → gentle reminder push to inviter ("Priya still hasn't joined — nudge her?").
• User quits mid-quiz → resumes where they left off next open.

Sources

• couples-first
• household-as-billing-unit
• .context/designs/mobile/onboarding/pair-partner.html