Combine 'Why Are You Here?' and PMF survey prompts into a single onboarding step

[Copilot]

This PR addresses user feedback fatigue by combining the "Why Are You Here?" micro-prompt and PMF survey into a single, unified onboarding experience that shows after the user's second dose completion.

Problem

Currently, users encounter two similar feedback surveys in quick succession:

• "Why Are You Here?" prompt after their first dose
• PMF survey after their second dose

This creates redundant prompts during the critical onboarding period and may feel repetitive to users.

Solution

Combined Onboarding Survey - A single 5-step progressive survey that triggers after the second dose:

1. Step 1: "Why Are You Here?" question (8 predefined options + custom text for "Other")
2. Steps 2-5: PMF survey questions (disappointment, benefit person, main benefit, improvements)

Key Features

• ✅ Single trigger point: Shows once after 2nd dose (leverages higher usage signal)
• ✅ Progressive disclosure: One question at a time with progress indicator (X of 5)
• ✅ Fully skippable: Clear "X" button, never shown again once completed/skipped
• ✅ Non-blocking: Never interrupts core dose calculation functionality
• ✅ Mobile responsive: Optimized for both web and mobile interfaces

Technical Implementation

New Components

• components/CombinedOnboardingSurvey.tsx - Unified survey component
• lib/hooks/useCombinedOnboardingSurvey.ts - Combined survey logic and state management
• types/combined-onboarding-survey.ts - TypeScript definitions

Updated Components

• lib/hooks/useDoseCalculator.ts - Replaced separate survey hooks with combined survey
• app/(tabs)/new-dose.tsx - Updated screen flow to render combined survey

Data Continuity Preserved

All existing analytics events continue to fire separately for backward compatibility:

• why_here_prompt_response, why_here_prompt_skipped
• pmf_survey_shown, pmf_survey_completed, pmf_survey_skipped

Testing

• ✅ Trigger logic validated (shows after 2nd dose, not 1st or 3rd)
• ✅ Response structure supports both survey types
• ✅ Analytics events preserved for existing dashboards
• ✅ Skip functionality with proper event logging

Benefits

• Reduced survey fatigue: Single survey instead of two separate prompts
• Better timing: Users have more app experience when providing PMF feedback
• Maintained insights: All original data collection requirements preserved
• Streamlined UX: Cleaner onboarding flow with progress indication

Fixes #327.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
safe-dose	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jun 11, 2025 11:45pm