> ## 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.

# Re-engagement Flow

> Strategies and flows for re-engaging lapsed users — contextual triggers, win-back paths, and persona-specific re-engagement.

## Overview

User re-engagement is critical for retention. This flow documents how High IQ identifies at-risk users, what triggers can bring them back, and how the app adapts its experience for returning users.

## Re-engagement Decision Tree

```mermaid theme={null}
graph TD
    A[User Stops Using App] --> B{Days Inactive}

    B -->|7 days| C[At-Risk: Mild]
    B -->|14 days| D[At-Risk: Moderate]
    B -->|30 days| E[Dormant]
    B -->|90 days| F[Churned]

    C --> G[Passive Triggers]
    G --> G1[Achievement almost complete]
    G --> G2[Restock prediction alert]
    G --> G3[Daily story waiting]

    D --> H[Active Triggers]
    H --> H1[New features announcement]
    H --> H2[Dispensary menu updated]
    H --> H3[Database growth milestone]

    E --> I[Win-Back Triggers]
    I --> I1[Welcome back experience]
    I --> I2[Quick sync prompt]
    I --> I3[Recap of missed insights]

    F --> J[Re-acquisition]
    J --> J1[Fresh start option]
    J --> J2[Data still intact message]
```

## Return Visit Experience

```mermaid theme={null}
sequenceDiagram
    participant U as User
    participant App as High IQ
    participant DB as Convex

    U->>App: Open app after absence
    App->>DB: Check last activity date
    DB-->>App: Days since last activity

    alt 7-14 Days
        App->>U: Normal dashboard
        App->>U: Achievement nudge (if near)
    else 15-30 Days
        App->>U: Subtle "Welcome back" header
        App->>U: Quick Sync suggestion (if Gmail connected)
        App->>U: Highlight nearest achievement
    else 31-90 Days
        App->>U: Welcome back overlay
        App->>U: Show data summary (strains, orders, etc.)
        App->>U: Quick actions for re-engagement
        App->>U: What's new highlights
    else 90+ Days
        App->>U: Welcome back with data reassurance
        App->>U: All your data is still here
        App->>U: Fresh start suggestions
    end
```

## Contextual Re-engagement Triggers

```mermaid theme={null}
graph TD
    A[Trigger Check] --> B{User Data Context}

    B -->|Has Achievement at 80%+| C[Achievement Nudge]
    C --> C1[You're 2 favorites away from Curator!]

    B -->|Stash Running Low| D[Restock Alert]
    D --> D1[Your Blue Dream supply is running low]

    B -->|Has Gmail Connected| E[Quick Sync]
    E --> E1[New orders since your last visit?]

    B -->|Daily Stories Available| F[Story Notification]
    F --> F1[Your daily story is ready]

    B -->|Wishlist Strain Available| G[Availability Alert]
    G --> G1[A wishlisted strain is at your dispensary]

    B -->|New Feature Launched| H[Feature Announcement]
    H --> H1[Check out what's new]

    B -->|Spending Milestone Approaching| I[Stats Insight]
    I --> I1[You're close to a spending milestone]
```

## Persona-Specific Re-engagement

```mermaid theme={null}
graph TD
    A[Lapsed User Returns] --> B{Identify Persona}

    B -->|Casual Consumer| C[Simple Re-entry]
    C --> C1[Upload your latest receipt]
    C --> C2[Browse trending strains]

    B -->|Connoisseur| D[Data Appeal]
    D --> D1[New strains added to DB]
    D --> D2[Continue your rankings]
    D --> D3[Generate a notebook]

    B -->|Health-Conscious| E[Pattern Insight]
    E --> E1[Your consumption patterns]
    E --> E2[Health sync coming soon]

    B -->|Budget Optimizer| F[Financial Insight]
    F --> F1[Spending recap since last visit]
    F --> F2[Sync latest orders]

    B -->|Data Nerd| G[Achievement Pull]
    G --> G1[Achievements waiting to be earned]
    G --> G2[Streak can be restarted]
    G --> G3[New stats available]
```

## Win-Back Flow

```mermaid theme={null}
graph TD
    A[Dormant User Opens App] --> B[Welcome Back Screen]
    B --> B1[Your data is safe]
    B --> B2[Summary of your collection]

    B --> C{Quick Actions}
    C --> C1[Sync Recent Orders - Gmail]
    C --> C2[Upload a Receipt]
    C --> C3[Browse New Strains]
    C --> C4[Check Your Stats]

    C1 --> D[Re-populated Dashboard]
    C2 --> D
    C3 --> D
    C4 --> D

    D --> E[Achievement Nudge]
    E --> F[User Back in Active Loop]
```

## Streak Recovery

```mermaid theme={null}
graph TD
    A[Streak Broken] --> B{Which Streak?}

    B -->|Activity Streak| C[Counter Resets to 0]
    C --> C1[Previous achievement tiers preserved]
    C --> C2[Start building new streak]

    B -->|Daily Stories Streak| D[Counter Resets to 0]
    D --> D1[Previous tiers preserved]
    D --> D2[New story available tomorrow]

    A --> E[Encouragement Message]
    E --> E1[Streaks can be rebuilt]
    E --> E2[Focus on new streak goal]
```

## Edge Cases

| Scenario                                       | Behavior                                        |
| ---------------------------------------------- | ----------------------------------------------- |
| User returns after 1 year                      | All data intact, welcome back experience        |
| User returns to expired Pro subscription       | Features locked, data preserved, renewal prompt |
| User returns with new device                   | Sign in, data syncs from Convex                 |
| User returns after database grew significantly | New strains available, search works normally    |
| User returns but forgot password               | Password reset flow via Clerk                   |
| Gmail token expired during absence             | Re-authorization prompt during Quick Sync       |
| Achievements earned while dormant (impossible) | No background earning, only on app interaction  |
| User returns to app update required            | App Store redirect for update                   |

## Related Flows

<CardGroup cols={2}>
  <Card title="User Lifecycle" icon="arrows-spin" href="/help/user-flows/lifecycle">
    At-risk, dormant, and churned lifecycle states.
  </Card>

  <Card title="Achievement System" icon="medal" href="/help/user-flows/achievements">
    Achievements as re-engagement hooks.
  </Card>

  <Card title="User Personas" icon="users" href="/help/user-flows/personas">
    Persona-specific engagement patterns.
  </Card>

  <Card title="Master Journey" icon="route" href="/help/user-flows/master-journey">
    Re-entry points in the master journey.
  </Card>
</CardGroup>
