Parent Onboarding — /onboarding/
The 8-screen mobile enrollment flow that turns a marketing-site visitor into a paid Starlight family. Wrapped in a CSS iPhone bezel; only renders correctly at narrow viewport. State machine driven by goto(n).
Funnel target
The marketing dashboard records this flow as a lead → revenue funnel with these conversion rates (last 90 days):
| Stage | Count | Conversion to next |
|---|---|---|
| Leads | 47 | 26% |
| Magic link sent | 12 | 33% |
| Enrollment started | 4 | 50% |
| Enrollment completed | 2 | 100% |
| First visit booked | 2 | 50% |
| First charge succeeded | 1 | — |
Overall lead → revenue: 2.1% (industry avg DPC pediatrics: 1.4%).
Screens
1 · Marketing CTA / Email capture
Hero — "Your kid's pediatrician, actually available." Direct-Primary-Care · Pediatrics chip. Email field pre-filled lisa.martinez@gmail.com. Gold "Send me the link" CTA. Below: 4-row value prop (Text directly · Same-day appointments · One flat monthly price · Growth charts in pocket).
2 · Check email
Mail icon. "We sent a one-tap enrollment link to lisa.martinez@gmail.com." "Tap the link from your phone to continue. The link works once and expires in 24 hours." Demo button: "Demo: open link →".
3 · Welcome
Personalized welcome after magic-link tap. "Let's go →" CTA.
4 · Family registration (Step 1 of 4)
Two cards stacked:
- Parent / Guardian — first/last name (Lisa Martinez), mobile (512-555-0142), address (2418 W 39th St, Austin TX 78731), Relationship dropdown (Mother).
- Per-child sub-card — DOB · sex · allergies · current meds · prior provider.
"Continue →" advances to step 2.
5 · Sign agreements (Step 2 of 4)
Two e-signature cards:
- HIPAA Notice of Privacy Practices — auto-signed (mint check).
- DPC Membership Agreement — "Review & sign" navy button.
Signature pad with cursive "Lisa Martinez · 05/04/2026".
6 · Pick a plan (Step 3 of 4)
Three plan cards for a 2-children family:
| Plan | Price | Per-month equivalent | Notes |
|---|---|---|---|
| Monthly | $140/mo | $140/mo | "Pay as you go. Cancel anytime." |
| Quarterly | $385 / 3 mo | $128/mo | MOST POPULAR — gold border, save 8%, auto-renews every 3 mo |
| Annual | $1,440/yr | $120/mo | Best value · 12 months pre-paid |
Stripe Setup Intent placeholder strip below. "Save card & continue →".
7 · Pick first visit (Step 4 of 4)
- Provider chip: Dr. Yogini Prajapati · Pediatrician · Starlight Pediatrics, Austin.
- Visit type chips: Meet & greet · Well-visit (Sofia) · Well-visit (Diego).
- Day strip: Mon 5 · Tue 5 · Wed 6 (selected) · Thu 7 · Fri 8 · Sat 9 · Sun 10.
- Time slots: 9:30 AM · 10:30 AM (selected, navy) · 11:00 AM · 2:00 PM · 2:30 PM · 3:00 PM. Greyed-out slots already booked.
"Book & finish →".
8 · Confirmation
Mint hero "You're enrolled!" "Dr. Prajapati is reviewing your family chart right now. You'll get a text the moment she's activated."
WHAT HAPPENS NEXT list:
- 📱 Download the Starlight.MD app — push notifications, secure messaging, refill requests.
- ⏰ Wed May 6 · 10:30 AM — Sofia's well-visit. We'll send a reminder 24h before.
- ✉️ Welcome packet emailed — what to expect at your first visit + how to reach Dr. Prajapati.
- 💳 Card on file (no charge yet) — quarterly plan · $385 · charges after activation.
"Restart demo →" button at the bottom.
Data requirements
- Magic-link table —
{token, email, family_id_pending, expires_at, used_at}. Single use, 24h TTL. - Family registration — atomic create of Family + Guardian + N Patient records.
- E-sign storage — HIPAA NPP + DPC Membership Agreement stored as signed PDFs with audit log (IP, timestamp, signature image hash).
- Stripe Setup Intent — no charge; provider activation is what fires the first charge.
- Calendar reservation — slot held in provider's calendar at step 7.
- Activation handoff — provider gets a notification in the clinician app's Marketing pipeline ("Tasha Williams · enrollment completed · booked Thu" → Prep action).
Plan pricing (canonical from this prototype)
These are the v1 default plans for a 2-child family. The clinician-app patient list confirms the same monthly tier ($295 / mo for 2-kid families like Martinez and Brock — note the discrepancy with onboarding's $140/mo for 2 kids; either the onboarding flow shows discounted intro pricing or the clinician-app rate is per-child × 2). Reconcile with Erik before committing to v1 numbers.
| Cadence | 2-kid family rate | Per kid implied |
|---|---|---|
| Monthly | $140/mo | $70/mo |
| Quarterly | $385 / 3 mo ($128.33/mo) | $64.17/mo |
| Annual | $1,440/yr ($120/mo) | $60/mo |
Notes
- The flow is fully Spanish-localizable in spirit (Lisa Martinez, Diego, addresses in Austin). No actual i18n in the demo, but copy is short enough to be a small translation surface.
- Mobile-only by design. There's no desktop layout — the iPhone bezel is the canvas.
- Step indicators: 8-pip progress dot strip at the top, gold = current.