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

# Stash Management

> Track your cannabis inventory, log consumption sessions, manage quantities, and view your complete activity history.

## Overview

Stash Management is the core tracking feature of High IQ. It lets you maintain a live inventory of your cannabis products, log consumption sessions, track quantities, and review your complete activity history. Think of it as a personal cannabis library where every strain, purchase, and session is recorded.

Your stash data syncs in real-time across all your devices via Convex, so changes made on one device appear instantly on another.

## Key Features

<CardGroup cols={2}>
  <Card title="Live Inventory" icon="box">
    Track active strains with quantities in grams, eighths, quarters, halves, ounces, milligrams, or milliliters. See your total at a glance.
  </Card>

  <Card title="Multiple Product Types" icon="cannabis">
    Support for flower, pre-rolls, edibles, concentrates, vapes, and tinctures -- each with appropriate unit tracking.
  </Card>

  <Card title="Consumption Logging" icon="clock-rotate-left">
    Log sessions with how much you used, automatically updating your remaining quantity. Mark items empty when finished.
  </Card>

  <Card title="Activity Timeline" icon="timeline">
    A complete audit trail of every action: stash additions, consumption events, orders uploaded, favorites toggled, and collection changes.
  </Card>

  <Card title="Sorting & Filtering" icon="filter">
    Sort your stash by date added, alphabetical, strain type, dominant terpene, High Family (time of day), or amount remaining.
  </Card>

  <Card title="Bulk Operations" icon="list-check">
    Multi-select mode lets you mark multiple items as empty at once for fast cleanup.
  </Card>
</CardGroup>

## The Stash Screen

The Stash tab is one screen with one job: show what you own **right now**. From
top to bottom it is the Stash Hero Card, a row of three quick actions, your sort
and layout controls, and then your strain cards.

Each strain card shows:

* **Strain name** and type (sativa, hybrid, indica)
* **Remaining quantity** with unit
* **Product type** badge (flower, edible, etc.)
* **Dispensary** where purchased (if tracked)
* **Strain image** from the database (when matched)

### Quick Actions

Under the hero card, three tiles carry your all-time counts and open the screens
that answer the questions the Stash tab itself does not:

| Tile           | Count shown                 | Opens                               |
| -------------- | --------------------------- | ----------------------------------- |
| **Orders**     | Orders imported or uploaded | Your purchase archive               |
| **History**    | Events recorded             | The full-screen stash timeline      |
| **Collection** | Unique strains ever tracked | Your strain collection and rankings |

### History Screen

<Note>History used to be a tab inside the Stash screen. It is now its own
full-screen view, opened from the History quick action, with room for the Quick
Stats header, search, and all seven event filters.</Note>

The History screen opens on a chronological timeline of all stash-related
events, grouped by date, with:

* **Quick Stats** — all-time unique strains, orders, and favorites
* **Search** — searches the full archive server-side, not just loaded pages
* **Filter tabs** — All, Orders, Stash, Favorites, Dislikes, Collection, Rankings

Event types include:

| Event                     | Description                                       |
| ------------------------- | ------------------------------------------------- |
| Stash Added               | New strain added to inventory                     |
| Stash Updated             | Quantity or details modified                      |
| Stash Consumed            | Consumption session logged                        |
| Stash Marked Empty        | Item finished and archived                        |
| Order Uploaded            | Receipt or order imported                         |
| Favorite Added/Removed    | Strain favorited or unfavorited                   |
| Collection Status Changed | Strain moved between owned/tasted/wanted/disliked |
| Comparison Recorded       | Pairwise strain ranking completed                 |

## How to Add a Strain

<Steps>
  <Step title="Open Your Stash">
    Navigate to the Stash tab from the bottom navigation bar, or tap "View Stash" from the home dashboard.
  </Step>

  <Step title="Tap the Add Button">
    Use the "+" button in the header toolbar to start adding a new strain.
  </Step>

  <Step title="Search for the Strain">
    Type the strain name to search the 16,000+ strain database. If found, the strain profile data is automatically linked.
  </Step>

  <Step title="Enter Details">
    Set the quantity, unit (gram, eighth, quarter, etc.), product type, dispensary name, and any personal notes.
  </Step>

  <Step title="Save">
    The strain appears in your active stash immediately. Quantity tracking begins.
  </Step>
</Steps>

## How to Log Consumption

<Steps>
  <Step title="Select a Strain">
    Tap on any active strain card in your stash.
  </Step>

  <Step title="Update Quantity">
    Navigate to the Update Stash screen to adjust the remaining quantity. The difference is logged as a consumption event.
  </Step>

  <Step title="Mark Empty">
    When you finish a strain, mark it as empty. It moves out of your active stash but remains in your history for analytics.
  </Step>
</Steps>

## Adding Strains from Multiple Sources

Strains can enter your stash from several places:

| Source            | How It Works                                                       |
| ----------------- | ------------------------------------------------------------------ |
| **Manual**        | Add directly from the Stash screen                                 |
| **Order Upload**  | Upload a dispensary receipt photo; AI extracts items and adds them |
| **Strain Detail** | Tap "Add to Stash" from any strain profile page                    |
| **Quick Add**     | Use the Quick Actions grid on the home dashboard                   |
| **Gmail Import**  | Import order confirmation emails from Dutchie and other platforms  |
| **Bulk Import**   | Import multiple strains at once from a structured source           |

<Note>Bulk import is a planned feature and not yet available in the current app version.</Note>

## Stash Hero Card

At the top of the Stash screen, the **Stash Hero Card** gives you a live read on
your stash health. Nothing is hidden behind a disclosure — the whole card reads
in one pass:

| Row                      | What It Shows                                                                                                                                                 |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Title + status**       | "Your stash" (or your display name's stash) and a colored status: Stocked, Comfortable, Running Low, Critical, Time to re-up, or Start tracking for new users |
| **Grams + strain count** | Your current total in grams alongside the number of active strains                                                                                            |
| **Supply forecast**      | How many days your stash is estimated to last. Tap it to open Consumption Preferences for a personalized estimate                                             |
| **Composition**          | One bar, three lenses — see below                                                                                                                             |

### Composition Lenses

The composition bar answers "what kind of stash is this?" three different ways.
Tap **Type**, **Time**, or **Form** to switch which breakdown the bar shows;
each one carries a leaning caption and raw counts.

| Lens     | Segments                                                   | Example caption   |
| -------- | ---------------------------------------------------------- | ----------------- |
| **Type** | Sativa / Hybrid / Indica                                   | "Hybrid-leaning"  |
| **Time** | High Family — Morning through Night                        | "Evening-leaning" |
| **Form** | Flower / Pre-roll / Edible / Concentrate / Vape / Tincture | "Flower-heavy"    |

<Tip>The **Form** lens is the one grams alone can't tell you. 20g of flower and
20g of carts are very different stashes, and this is where that shows up.</Tip>

## Sorting Options

Use the sort chips above your strain list to organize by:

| Sort        | Behavior                                                               |
| ----------- | ---------------------------------------------------------------------- |
| **Recent**  | Most recently added first (default)                                    |
| **A-Z**     | Alphabetical by strain name                                            |
| **Type**    | Grouped by sativa, hybrid, indica                                      |
| **Terpene** | Grouped by dominant terpene                                            |
| **Time**    | Grouped by High Family recommended time of day (morning through night) |
| **Amount**  | Sorted by remaining quantity in grams                                  |

Each sort that supports it can be toggled between ascending and descending order.

## Card Variants

You can change how your stash items are displayed by tapping the card variant selector:

| Variant       | Description                                                |
| ------------- | ---------------------------------------------------------- |
| **Mascot**    | Two-column grid with strain mascot illustrations (default) |
| **Strain**    | Cards featuring strain photography                         |
| **Split**     | Side-by-side layout with image and details                 |
| **Condensed** | Compact grid showing key info                              |
| **Compact**   | Minimal list view for maximum density                      |

## Restock Predictions

If you set your consumption preferences (accessible from the Stash screen), High IQ can predict when you will run out of each strain based on your typical usage rate. Low-stock warnings appear as alert banners.

<Tip>
  Set your **Consumption Preferences** to enable accurate restock predictions. Go to the **You** tab > Consumption Preferences to configure your typical daily frequency and average session amount per consumption method.
</Tip>

<Tip>
  Use **bulk mark-empty** to clean up multiple finished strains at once. Enter edit mode by tapping the edit button in the header, select the items, then tap "Mark Empty."
</Tip>

<Snippet file="contact-support.mdx" />
