Onboarding Flow

Overview

The onboarding flow is the most critical user journey in High IQ. It determines whether a new user becomes an active user or abandons the app. The goal is simple: get the user to their first “aha” moment — seeing their cannabis data organized, analyzed, and actionable — as fast as possible.

Onboarding Funnel

Authentication Flow

Authentication Edge Cases

Edge Case	Behavior
User already has account (Google)	Silently signs in, redirects to dashboard
User already has account (email)	“Account exists” message with sign-in option
Apple hides email	Account created with relay email, works normally
Network failure during auth	Error toast with retry button, no partial state
Force quit during auth	Resumes at auth screen on next launch
OAuth popup blocked	Fallback instructions displayed
Email verification timeout	Resend button after 60 seconds

First Action Paths

This page summarizes several activation choices. For the source-of-truth implementation status and recovery paths for text entry, Gmail import, shops, and unknown-strain research, see Order Activation: Import, Review, and Research.

Path A: Manual Strain Entry (Fastest — 30 seconds)

Edge cases:

Scenario	Handling
Strain not found in database	Option to add custom strain name
Duplicate strain in stash	Warning with option to update existing
No quantity entered	Saves with “unknown” quantity
Network offline	Queued locally, syncs when online

Path B: Receipt Photo Upload (2 minutes)

Edge cases:

Scenario	Handling
Blurry photo	”Image too blurry” with retake prompt
Not a receipt	”This doesn’t look like a receipt” message
Handwritten receipt	AI attempts extraction, lower confidence
Digital screenshot receipt	Works well, high confidence
Receipt in non-English	Currently English only, error message
Very long receipt (20+ items)	Scrollable review, batch processing
Duplicate receipt upload	Duplicate warning with option to proceed
Partial extraction (some items missed)	Review screen allows manual additions

Path C: Gmail Import (3 minutes, highest value)

Edge cases:

Scenario	Handling
Google declines permissions	Clear message explaining read-only scope, retry option
No saved shop domain	Create or update a shop inline, or explicitly choose a broad historical scan
Zero receipts found	Empty state offers text entry, another range, or improved shop setup
Mixed confidence results	Candidate review lets the user exclude false positives before import
Import interrupted	Durable scan and import jobs retain resumable progress
Duplicate Gmail message IDs	Existing imports are skipped idempotently
Non-dispensary emails matched	Server classification plus candidate review reduces false positives
Parsed receipt needs correction	Every successful Gmail parse opens the same editable Review & Confirm screen as text input before commit
Gmail disconnected during work	The connection generation is invalidated so stale work cannot keep importing

Path D: Label Scanner (15 seconds, discovery-oriented)

First Value Moment Map

The “aha” moment differs by user type and first action:

Post-Onboarding Guidance

After the first value moment, the app surfaces contextual next-step prompts:

User Has	Next Step Prompt	Where Shown
1 strain in stash	”Generate your first AI notebook”	Dashboard card
1 order but no dispensary	”Save your dispensary for menu scanning”	Dashboard card
Strains but no favorites	”Heart your favorites for better recommendations”	Strain profile
3+ strains, no rankings	”Start ranking your strains”	Collection screen
Data but hasn’t asked AI	”Ask Professor High about your stash”	Dashboard tools

Master Journey

Where onboarding fits in the complete journey.

Order Upload Flow

Deep dive into all order import methods.

User Personas

How different personas experience onboarding.

Authentication

Authentication states and edge cases.

Getting Started

Plans

Features

Social Content

Troubleshooting

Account & Privacy

User Flows

FAQ

Overview

Onboarding Funnel

Authentication Flow

Authentication Edge Cases

First Action Paths

Path A: Manual Strain Entry (Fastest — 30 seconds)

Path B: Receipt Photo Upload (2 minutes)

Path C: Gmail Import (3 minutes, highest value)

Path D: Label Scanner (15 seconds, discovery-oriented)

First Value Moment Map

Post-Onboarding Guidance

Master Journey

Order Upload Flow

User Personas

Authentication

​Overview

​Onboarding Funnel

​Authentication Flow

​Authentication Edge Cases

​First Action Paths

​Path A: Manual Strain Entry (Fastest — 30 seconds)

​Path B: Receipt Photo Upload (2 minutes)

​Path C: Gmail Import (3 minutes, highest value)

​Path D: Label Scanner (15 seconds, discovery-oriented)

​First Value Moment Map

​Post-Onboarding Guidance

​Related Flows

Master Journey

Order Upload Flow

User Personas

Authentication

Overview

Onboarding Funnel

Authentication Flow

Authentication Edge Cases

First Action Paths

Path A: Manual Strain Entry (Fastest — 30 seconds)

Path B: Receipt Photo Upload (2 minutes)

Path C: Gmail Import (3 minutes, highest value)

Path D: Label Scanner (15 seconds, discovery-oriented)

First Value Moment Map

Post-Onboarding Guidance

Related Flows