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

# Home Dashboard

> Your personalized home screen with quick actions, stash preview, stats snapshot, and trending strains.

## Overview

The Home Dashboard is the first screen you see when you open High IQ. It serves as your command center, giving you a quick view of your current stash, recent activity, key stats, collection progress, and trending strains -- all in one scrollable feed with a modern glass-morphism design.

The dashboard adapts to your sign-in state. Signed-out users see preview cards with locked overlays that showcase what each feature looks like when unlocked.

## Dashboard Sections

The home screen is organized into modular sections from top to bottom:

<CardGroup cols={2}>
  <Card title="Hero Header" icon="image">
    A gradient header with a personalized greeting, featured strain spotlight, and stash preview at a glance.
  </Card>

  <Card title="Strain Search" icon="magnifying-glass">
    Quick-access search bar to jump directly into the 16,000+ strain database from the Dashboard.
  </Card>

  <Card title="Quick Actions" icon="bolt">
    A 4-button action grid for your most common tasks: Upload, Discover, Label Scanner, and Music.
  </Card>

  <Card title="Tools Section" icon="wrench">
    Quick access to your tools: My Collection and educational guides (Learn). Ask Professor High and the Shop Scanner also appear here when those beta features are enabled.
  </Card>

  <Card title="Upload Order CTA" icon="receipt">
    A prominent call-to-action to upload dispensary receipts, import orders, or add purchases to start building your consumption history.
  </Card>

  <Card title="Current Strains" icon="cannabis">
    A live preview of your active stash with total grams, strain count, and a type composition bar showing your sativa/hybrid/indica balance.
  </Card>

  <Card title="Stats Preview" icon="chart-pie">
    A snapshot of your key lifetime metrics: total orders, total spent, unique strains tried, and average order value.
  </Card>

  <Card title="Collection Preview" icon="layer-group">
    Summary of your strain collection with counts for owned, tasted, and wishlist strains, plus your top-ranked strains.
  </Card>

  <Card title="Rankings Preview" icon="trophy">
    Your current strain rankings with ELO ratings, number of comparisons completed, and a prompt to start ranking if you have enough strains.
  </Card>

  <Card title="Order Insights" icon="chart-line">
    A preview of your latest AI-generated notebook, including the executive insight summary and notebook status.
  </Card>

  <Card title="Stash Stats" icon="boxes-stacked">
    A 3-card stats row showing active strain count, favorite strain type, and total grams in your stash.
  </Card>

  <Card title="Achievement Nudge" icon="trophy">
    Your nearest achievement goal at 80%+ progress with a progress bar, achievement name, and tap target to view details.
  </Card>

  <Card title="Trending Strains" icon="fire">
    A horizontally scrollable carousel of popular strains from the database, updated regularly.
  </Card>
</CardGroup>

Additionally, the bottom of the dashboard includes a **Blog Section** with the latest articles from thisiswhyimhigh.com.

## Pull to Refresh

The entire dashboard supports pull-to-refresh. When you pull down, High IQ refreshes all data sources in parallel:

* Stash inventory and stats from Convex
* Latest reports and collection data
* Blog article cache (cleared and refetched)
* API health check

## Quick Actions Grid

The Quick Actions section provides fast access to the four most common tasks:

<Steps>
  <Step title="Upload">
    Navigate to the order upload flow to scan or photograph a dispensary receipt for automatic order import.
  </Step>

  <Step title="Discover">
    Jump to Strain Discovery with search, filters, and curated lists.
  </Step>

  <Step title="Label Scanner">
    Open the AI Label Scanner to photograph a product label and get instant terpene extraction and High Family classification. (Pro feature.)
  </Step>

  <Step title="Music">
    Open Strain Soundtracks to play AI-generated music composed for each strain.
  </Step>
</Steps>

## Signed-Out Experience

If you are not signed in, the dashboard still displays all sections but wraps personal data in **Locked Preview Overlays**. These overlays show realistic mock data (e.g., mock stash with 24.5g across 6 strains) so you can see what the feature looks like before creating an account.

Tapping any locked section prompts you to sign in.

## API Health Indicator

The dashboard includes an automatic health check that runs every 30 seconds. If the API server is offline, a subtle warning banner appears at the top:

<Warning>
  **API Server Offline** -- Some features may be limited. Stash management and notebooks continue to work since they use Convex (real-time sync), but strain search, trending strains, and label scanning require the API.
</Warning>

## Tips

<Tip>
  **Pull down to refresh** if data looks stale. The dashboard caches data for performance, so a manual refresh ensures you see the latest stats and reports.
</Tip>

<Tip>
  Tap the **"View Stash"** link next to "Current Strains" to jump directly to your full stash management screen with sorting, card variants, and history timeline.
</Tip>

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