> ## Documentation Index
> Fetch the complete documentation index at: https://docs.highailabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Master User Journey

> The complete end-to-end user journey map for High IQ — from first app open to power user, covering every state, transition, and milestone.

## Overview

This page maps the complete user journey through the High IQ mobile app — from the moment a user downloads the app to becoming a power user with deep engagement across all features. Every user passes through distinct phases, each unlocking new capabilities and deepening their relationship with the platform.

## Master Journey Map

```mermaid theme={null}
graph TD
    A[App Download] --> B[First Launch]
    B --> C{Signed In?}
    C -->|No| D[Signed-Out Experience]
    C -->|Yes| E[Onboarding Complete]

    D --> D1[Preview Dashboard]
    D1 --> D2[Browse Locked Features]
    D2 --> D3[Tap Locked Card]
    D3 --> D4[Sign-In Prompt]
    D4 --> C

    E --> F[Empty State - Phase 1]
    F --> G{First Action}

    G -->|Add Strain| H[Manual Stash Entry]
    G -->|Upload Receipt| I[Receipt Photo Upload]
    G -->|Scan Label| J[Label Scanner]
    G -->|Browse Strains| K[Strain Discovery]
    G -->|Gmail Import| L[Gmail Sync Wizard]

    H --> M[First Strain in Stash]
    I --> M
    J --> M
    K --> K1[Favorite a Strain]
    K1 --> M
    L --> M

    M --> N[Active User - Phase 2]
    N --> N1[Generate First Notebook]
    N --> N2[Add Dispensary]
    N --> N3[Start Ranking]
    N --> N4[View Stats]
    N --> N5[Ask Professor High]

    N1 --> O[Engaged User - Phase 3]
    N2 --> O
    N3 --> O
    N4 --> O
    N5 --> O

    O --> P[Regular Habits]
    P --> P1[Weekly Orders]
    P --> P2[Daily Stories]
    P --> P3[Achievement Hunting]
    P --> P4[Shopping Agent Use]

    P1 --> Q[Power User - Phase 4]
    P2 --> Q
    P3 --> Q
    P4 --> Q

    Q --> Q1[50+ Strains Collected]
    Q --> Q2[Multiple Dispensaries]
    Q --> Q3[Full Rankings]
    Q --> Q4[Pro Subscriber]
    Q --> Q5[Level 15+]

    style A fill:#f0f9ff
    style E fill:#ecfdf5
    style M fill:#fef3c7
    style O fill:#ede9fe
    style Q fill:#fce7f3
```

## Journey Phases

### Phase 0: Pre-Authentication

The user has downloaded the app but has not signed in. They experience a preview version of the dashboard.

```mermaid theme={null}
stateDiagram-v2
    [*] --> AppOpened
    AppOpened --> PreviewDashboard
    PreviewDashboard --> BrowseLockedFeatures
    BrowseLockedFeatures --> TapLockedCard
    TapLockedCard --> SignInPrompt
    SignInPrompt --> CreateAccount: New User
    SignInPrompt --> SignIn: Returning User
    SignInPrompt --> PreviewDashboard: Dismiss
    CreateAccount --> OnboardingComplete
    SignIn --> OnboardingComplete
    OnboardingComplete --> [*]
```

**Key states:**

| State             | What the User Sees                                              |
| ----------------- | --------------------------------------------------------------- |
| Preview Dashboard | Mock data with locked overlays (e.g., "24.5g across 6 strains") |
| Locked Feature    | Realistic preview with glass-morphism lock overlay              |
| Sign-In Prompt    | Authentication modal triggered by tapping any locked section    |

**Edge cases:**

* User force-quits during sign-up — resumes at last completed step
* User has Google account but declines Gmail permissions — proceeds without Gmail sync
* Network offline during sign-in — error message with retry option

***

### Phase 1: Empty State (First 5 Minutes)

The user has authenticated but has zero data. Every feature shows empty states with clear calls-to-action.

```mermaid theme={null}
graph LR
    A[Authenticated] --> B[Empty Dashboard]
    B --> C[Empty Stash]
    B --> D[Empty Notebooks]
    B --> E[Empty Collection]
    B --> F[Empty Stats]

    C --> C1[Add First Strain CTA]
    D --> D1[No Data Yet Message]
    E --> E1[Start Collecting CTA]
    F --> F1[Add Data to See Stats]

    C1 --> G[First Data Entry]
    G --> H[Phase 2: Active User]
```

**Key actions available:**

1. Add a strain manually (search 16,000+ database)
2. Upload a receipt photo
3. Scan a product label
4. Browse strain database
5. Connect Gmail for bulk import
6. Ask Professor High a question

**First-time value triggers:**

| Trigger              | Time to Value | Impact                                       |
| -------------------- | ------------- | -------------------------------------------- |
| Add first strain     | \~30 seconds  | Stash populated, dashboard comes alive       |
| Upload first receipt | \~2 minutes   | Multiple strains added, order history begins |
| Gmail import         | \~3 minutes   | Months of history imported, stats populated  |
| Scan first label     | \~15 seconds  | Terpene data extracted, High Family revealed |

***

### Phase 2: Active User (First Week)

The user has some data and is exploring features.

```mermaid theme={null}
graph TD
    A[Has Data in Stash] --> B{Explore Features}

    B --> C[Stash Management]
    C --> C1[Sort & Filter]
    C --> C2[Change Card Variants]
    C --> C3[Log Consumption]
    C --> C4[Mark Empty]

    B --> D[Notebooks]
    D --> D1[Generate First Notebook]
    D1 --> D2[View 5-Tab Analysis]
    D2 --> D3[Experience Story View]

    B --> E[Collection]
    E --> E1[Set Collection Statuses]
    E1 --> E2[Start ELO Rankings]
    E2 --> E3[Head-to-Head Comparisons]

    B --> F[Dispensaries]
    F --> F1[Save First Dispensary]
    F1 --> F2[Add Menu URLs]
    F2 --> F3[Try Shopping Agent]

    B --> G[Ask AI]
    G --> G1[Personal Questions]
    G --> G2[Strain Research]
    G --> G3[Recommendations]

    B --> H[Stats Dashboard]
    H --> H1[Overview Metrics]
    H --> H2[Activity Heatmap]
    H --> H3[Spending Charts]
```

**Key milestones:**

| Milestone                | Unlocks                                  |
| ------------------------ | ---------------------------------------- |
| 3 strains in stash       | ELO ranking available                    |
| First notebook generated | Stories viewer, Daily Stories            |
| First dispensary saved   | Shopping Agent available                 |
| 5 consumption events     | Predictive analytics (velocity, restock) |
| First favorite saved     | Personalized recommendations improve     |

***

### Phase 3: Engaged User (Weeks 2-4)

Regular usage patterns emerge. The user develops habits around specific features.

```mermaid theme={null}
graph TD
    A[Engaged User] --> B[Regular Order Upload]
    A --> C[Daily Story Viewing]
    A --> D[Achievement Progress]
    A --> E[Collection Curation]
    A --> F[Shopping Agent Prep]

    B --> B1[Receipt Photos]
    B --> B2[Gmail Quick Sync]
    B --> B3[Manual Entry]

    C --> C1[Morning Story Check]
    C1 --> C2[Build Viewing Streak]
    C2 --> C3[Daily Stories Achievement]

    D --> D1[Track Active Quests]
    D1 --> D2[Earn Common Badges]
    D2 --> D3[Earn Rare Badges]
    D3 --> D4[Level Up Identity]

    E --> E1[Mark Owned/Tasted/Wanted]
    E1 --> E2[Regular Rankings]
    E2 --> E3[Definitive Top 5]

    F --> F1[Save Dispensary Menus]
    F1 --> F2[Pre-Visit Scan]
    F2 --> F3[Informed Purchase]
```

***

### Phase 4: Power User (Month 2+)

Deep engagement across all features with strong data history.

```mermaid theme={null}
graph TD
    A[Power User] --> B[Data-Rich Profile]
    A --> C[Full Analytics Use]
    A --> D[Advanced AI Usage]
    A --> E[Achievement Mastery]
    A --> F[Community Contribution]

    B --> B1[50+ Strains Collected]
    B --> B2[Multiple Dispensaries]
    B --> B3[Months of History]
    B --> B4[Complete Rankings]

    C --> C1[Spending Optimization]
    C --> C2[Consumption Velocity]
    C --> C3[Restock Predictions]
    C --> C4[Pattern Analysis]

    D --> D1[Complex AI Queries]
    D --> D2[Menu Scan Comparisons]
    D --> D3[Personalized Plans]

    E --> E1[Epic & Legendary Badges]
    E --> E2[Level 15+]
    E --> E3[Featured Achievements]
    E --> E4[Identity Title Earned]

    F --> F1[Queue New Strains]
    F --> F2[Gmail Domain Contributions]
    F --> F3[Label Scan Submissions]
```

## User Progression Metrics

```mermaid theme={null}
pie title User Engagement Distribution (Target)
    "Phase 0 - Preview Only" : 30
    "Phase 1 - Empty State" : 15
    "Phase 2 - Active User" : 25
    "Phase 3 - Engaged User" : 20
    "Phase 4 - Power User" : 10
```

## Key Conversion Points

| From → To   | Primary Trigger         | Secondary Trigger           |
| ----------- | ----------------------- | --------------------------- |
| Phase 0 → 1 | Tap locked feature      | Browse strain, want to save |
| Phase 1 → 2 | Add first strain        | Upload first receipt        |
| Phase 2 → 3 | Generate first notebook | Earn first achievement      |
| Phase 3 → 4 | Subscribe to Pro        | 30+ strains collected       |

## Drop-Off Risk Points

| Risk Point                | Why Users Drop Off       | Mitigation                                              |
| ------------------------- | ------------------------ | ------------------------------------------------------- |
| Empty stash (Phase 1)     | No clear starting action | Quick Actions grid with "Upload Receipt" as primary CTA |
| First notebook generation | Too slow or confusing    | Real-time progress indicator, auto-navigate to results  |
| Gmail permissions         | Privacy concern          | Read-only badge, clear privacy messaging                |
| Achievement plateau       | No new goals             | Active Quests surface nearest achievements at 80%+      |
| Pro paywall               | Cost resistance          | First notebook free, feature previews in locked state   |

## Related Flows

<CardGroup cols={2}>
  <Card title="User Lifecycle" icon="arrows-spin" href="/help/user-flows/lifecycle">
    Detailed lifecycle states from signup through retention and re-engagement.
  </Card>

  <Card title="Onboarding Flow" icon="right-to-bracket" href="/help/user-flows/onboarding">
    First-time user experience from download to first value.
  </Card>

  <Card title="User Personas" icon="users" href="/help/user-flows/personas">
    The five user personas and their unique journeys.
  </Card>

  <Card title="Feature Adoption" icon="chart-line" href="/help/user-flows/feature-adoption">
    How users discover and adopt each feature over time.
  </Card>
</CardGroup>
