# User Flow

The **MoonSense user journey** is designed to be simple, intuitive, and powerful:

1. **Onboarding & Authentication**
   * User visits MoonSense web app.
   * Prompted to **connect wallet** via SIWE.
   * Successful authentication generates a secure JWT session.
2. **Dashboard View**
   * User lands on the **Dashboard**:
     * Real-time market prices (via free APIs like CoinGecko).
     * Trending tokens and new launches.
     * Quick portfolio overview (if connected wallet holds tokens).
3. **AI Analysis Page**
   * User navigates to the **AI Analysis** tab.
   * AI displays categorized insights:
     * **Memecoins**: Ranked by hype and virality.
     * **Altcoins**: Ranked by adoption and development strength.
     * **New Launches**: Ranked by tokenomics and rug risk.
   * Each coin card shows the **Moon Potential Score**, trend charts, and sentiment highlights.
4. **Watchlist & Alerts**
   * User can **add coins to a watchlist**.
   * Set alerts for:
     * MPS threshold crossing.
     * Price milestones.
     * Sudden hype surges.
   * Notifications via **in-app, Telegram bot, or email (future)**.
5. **Engagement Loop**
   * Users return daily for updated insights.
   * Gamified elements (e.g., badges for “Early Moon Catcher”) to increase retention.
