Overview
Notebooks are High IQ’s flagship AI feature — transforming raw purchase data into multi-layered analysis with streaming generation, visual stories, and daily recaps. This page documents every flow from generation trigger through consumption.Notebook Generation Flow
Notebook Type Selection
Generation Progress States
Cancel flow: The progress sheet includes a Cancel action at every stage. Tapping it shows a confirmation alert (“Keep Generating” / “Cancel Generation”) so a stray tap never kills a run. Canceled notebooks remain in the list and can be retried. Partial failure: If some sections fail but others complete, the notebook opens normally with all completed sections rendered. An inline banner reports the failed-section count with a Retry failed sections action — retrying regenerates the entire notebook, so a confirmation warns that completed sections will be replaced. While generation is active, each section row in the progress tracker also exposes its own retry button. Progress bar stages:| Stage | Progress | Duration | What Happens |
|---|---|---|---|
| Queued | 0% | ~1s | Request sent to API |
| Analyzing | 5-15% | ~3s | Gathering stash data, strain profiles, terpene info |
| Generating | 15-25% | ~5s | AI model warming up, context prepared |
| Streaming | 25-90% | 20-90s | Sections generated one by one with visible text |
| Finalizing | 90-95% | ~3s | Computing insights, saving to database |
| Completed | 100% | Instant | Auto-navigate to detail view |
Notebook Detail View — 5-Tab Navigation
Stories Viewer Flow
Story interaction:| Gesture | Action |
|---|---|
| Tap right side (70%) | Next page |
| Tap left side (30%) | Previous page |
| Swipe left | Next story in queue |
| Swipe right | Previous story in queue |
| Swipe down | Close story |
Daily Stories Flow
Free vs. Pro Notebook Access
Notebook generation is part of the Pro tier. Non-subscribers see the Notebooks screen with sample content; generating a notebook prompts an upgrade.Edge Cases
| Scenario | Behavior |
|---|---|
| Only 1 strain selected | Notebook generated but less comparative insight |
| Stream disconnects mid-generation | Partial notebook saved, retry option for remaining sections |
| Some sections fail, others complete | Notebook opens with completed sections + inline banner with “Retry failed sections” (full regeneration, confirmed) |
| User cancels from progress sheet | Confirmation alert, then generation stops; notebook stays in list for later retry |
| Generation takes > 2 minutes | Extended progress message shown |
| AI returns empty section | Section skipped with “Not enough data” message |
| User closes app during generation | Generation continues server-side, notebook appears on return |
| Network offline | Error message, retry when online |
| Duplicate notebook for same strains | Allowed — different AI analysis each time |
| Notebook regenerated after media was created | Existing media cards show an “Outdated” badge until media is refreshed |
| Media stuck generating > ~30 minutes | Card switches from “Generating…” to a failed state instead of pulsing forever |
| Daily Story for day with single event | Minimal story, still counts for streak |
| Notebook for archived/empty stash items | Works — uses historical data |
| Error during finalization | Error preserved with stage info for debugging |
Notebook Media Flow
Media generates in the background after the notebook text completes and each type arrives independently. Media types can be enabled or disabled remotely, so the visible set of cards varies — disabled types are hidden rather than shown as “coming soon.” Share Card: Independent of generated media, every notebook can render a first-party Share Card — a branded 4:5 order summary built directly from notebook data. It opens from the notebook header menu (••• → Share Card) and shares as a PNG image via the native share sheet, falling back to a text summary + deep link when image capture is unavailable.Related Flows
Order Upload
How orders create data for notebooks.
Stash Management
Selecting stash items for analysis.
Stats & Analytics
How notebook data feeds into analytics.
Achievement System
Notebook Mastery and Daily Stories tracks.