bpinheiroms/dotfiles/onboarding-planner

1. What's the app? (name + one-sentence description)
2. What's the core "magic" feature? (the one thing users would pay for)
3. Business model? (freemium / trial+subscription / one-time / ads)
4. Pricing? (monthly, annual, trial days)
5. Platform? (iOS, Android, both)

6. Who's the ideal user? (age range, context, lifestyle)
7. What's their main pain? (the problem that makes them search for this app)
8. What's the "trigger moment"? (when do they decide to look for a solution)
9. Knowledge level? (beginner, intermediate, expert in the domain)
10. Where do they come from? (ads, organic search, referral, influencers, TikTok)

11. Can you simulate the core feature in onboarding? (interactive demo before signup)
12. What data do you NEED to personalize the experience? (weight, age, level, goals, etc.)
13. Does the app have social features? (community, leaderboard, sharing)
14. Does it have referral/affiliate program?
15. What permissions does the app need? (notifications, camera, location, contacts, health data)

16. Is there an existing onboarding? (if yes, what are current metrics)
17. Direct competitors? (for benchmark reference)
18. Languages supported?
19. Any App Store restrictions or guidelines to follow?
20. Any hard constraints? (must collect X before Y, legal requirements, etc.)

SECTION A: ENTRY (1-2 screens)
  First impression. Video/image showing the app in action.
  Language picker if multi-language.
  CTA: "Start Quiz" or "Discover your plan" (NOT "Sign up")
  Secondary: "Already have an account? Sign in"
 
  WHY: Frame as discovery/quiz, not registration. Reduces perceived commitment.
 
SECTION B: EASY QUESTIONS (3-5 screens)
  Start with trivially easy questions (gender, age range, activity level).
  Insert 1 BRIDGE after 2-3 questions.
 
  WHY: Foot-in-the-door technique. Easy questions build momentum.
  RULE: Subtitle on every question explains WHY you're asking.
        Example: "This will be used to calibrate your personalized plan"
 
SECTION C: GOALS & EMOTIONS (3-4 screens)
  Main goal question (what do you want to achieve?)
  Quantified goal (target weight, target level, etc.)
  Emotional state question ("How do you feel about X today?")
  Bridge: Mirror their answer back ("You said you're determined!")
  Bridge: Validate their goal ("Your goal is totally realistic!")
 
  WHY: Identity commitment + emotional activation = strongest conversion drivers.
 
SECTION D: DEPTH QUESTIONS (3-5 screens)
  Obstacles ("What's stopping you?") - multi-select
  Desires ("What would you like to achieve?") - multi-select
  Preferences (pace, difficulty, style)
  Conditional branching (knowledge check -> education if needed)
  Bridges with authority data between questions.
 
  WHY: Deepens investment. Each answer makes the plan feel more "theirs."
 
SECTION E: FEATURE DEMO / AHA MOMENT (2-5 screens)
  Interactive simulation of the core feature.
  User DOES something (taps, swipes, interacts).
  Shows personalized result based on their data.
 
  WHY: This is the single most important conversion moment.
  The user experiences value BEFORE being asked to pay.
  MANDATORY before paywall.
 
SECTION F: SOCIAL PROOF (2-3 screens)
  Individual testimonial (before/after, specific numbers, photo)
  Aggregate proof (X users, Y stars, featured review)
  App Store rating request (OPTIONAL - controversial, see notes)
  Value proposition summary (4 key benefits with icons)
 
  WHY: Addresses "is this legit?" objection right before paywall.
 
SECTION G: PERMISSIONS & IDENTITY (2-5 screens)
  Notification permission (show example notifications, explain value)
  Name input (SKIPPABLE)
  Email input (SKIPPABLE)
  Referral code (SKIPPABLE)
 
  WHY: Placed LATE because sunk cost from 20+ answered questions
  makes users more likely to provide data.
  RULE: Every identity field MUST be skippable.
 
SECTION H: PLAN GENERATION (1-2 screens)
  Animated loading ("Analyzing your data..." with checklist)
  Social proof during wait ("5,000+ 5-star reviews")
 
  WHY: Creates illusion of personalized computation.
  Increases perceived value of the result.
  NOTE: Keep it short (5-8 seconds). Long fake loading is a dark pattern.
 
SECTION I: PLAN REVEAL + PAYWALL (3-8 screens)
  Personalized plan with user's specific data and target date.
  CTA: "Get your X free days"
  If dismissed: Recovery flow (discount wheel, better offer, etc.)
  Plan selector: Annual vs Monthly (annual as default, marked "MOST POPULAR")
  Trial reassurance: "We'll remind you before trial ends"
 
  WHY: User now OWNS the plan (endowment effect).
  Leaving = losing something that was built for them.
 
SECTION J: POST-ONBOARDING (2-4 screens)
  Account creation (Google/Apple/Email) - LATE, after paywall
  Quick product tour (max 5-8 steps, skippable)
  Community setup if applicable (nickname, avatar)
  Referral/affiliate CTA if applicable
 
  WHY: Account creation is placed after paywall because user has
  maximum sunk cost and is most likely to complete.