> ## Documentation Index
> Fetch the complete documentation index at: https://help.fanaura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard Overview

> Your real-time command center. Understand stat cards, date range filters, fan growth charts, recent activity, and active launches.

The Dashboard is your real-time command center. It is the first thing you see when you log in and gives you an instant snapshot of your fan base, campaign performance, and live activity. Everything on this page updates in real time -- when a fan presaves your song at 2am, you will see it here the moment it happens.

<Frame caption="The Fanaura Dashboard showing fan analytics, recent activity, and active launches.">
  <img src="https://mintcdn.com/fanaurainc/RnYfBYSFirNGTEEw/images/dashboard-overview.png?fit=max&auto=format&n=RnYfBYSFirNGTEEw&q=85&s=f2aba83233abc357de03debd42057a96" alt="Fanaura Dashboard Overview" width="2880" height="1800" data-path="images/dashboard-overview.png" />
</Frame>

<Tip>Bookmark your Dashboard or set it as your browser's startup page. A quick daily glance takes under 10 seconds and tells you everything you need to know about your fan base health.</Tip>

***

## Accessing the Dashboard

Click **"Dashboard"** in the sidebar navigation or navigate directly to `/dashboard`. The Dashboard is the default landing page after onboarding.

***

## Page Layout

The Dashboard is organized into three main sections, from top to bottom:

1. **Header with date range filter** -- control the time window for all data
2. **Fan Analytics** -- stat cards, charts, and insights
3. **Real-Time section** -- recent activity feed and active launches widget

***

## Date Range Filter

In the page header (top-right area), you will find the date range selector. It is a row of pill-shaped buttons that let you control what time period all dashboard data covers.

### Available Ranges

| Button       | Time Range             | Best For                    |
| ------------ | ---------------------- | --------------------------- |
| **24h**      | Last 24 hours          | Checking how today is going |
| **7 Days**   | Last 7 days            | Weekly check-in             |
| **30 Days**  | Last 30 days           | Monthly performance review  |
| **90 Days**  | Last 90 days           | Quarterly analysis          |
| **1 Year**   | Last 365 days          | Annual trends               |
| **All Time** | Since account creation | The big picture             |

The selected range is highlighted with a bright white background. Clicking a different range immediately updates all data on the page -- stat cards, charts, and analytics all respond to the selected time window.

<Info>The default range when you first open the Dashboard is **All Time**, so you see everything from day one.</Info>

***

## Stat Cards

At the top of the analytics section, you will see a row of stat cards. On desktop, these display as 6 cards in a single row. On mobile, they wrap into 2 columns.

The stat cards are powered by the **FanAnalyticsTab** component running in "overview" mode. They provide key performance indicators for your selected date range.

### Common Stats Displayed

* **Total Fans** -- the total number of fans in your database
* **New Fans** -- how many fans were added during the selected period
* **Presaves** -- total presave count for the period
* **Engagement Rate** -- the percentage of fans who have taken an action
* **Top Source** -- the most common acquisition channel (presave, merch, RSVP, etc.)
* **Active Campaigns** -- how many launches are currently running

Each card shows:

* A label describing the metric
* A large, bold number or percentage
* A trend indicator (up/down arrow with percentage change from the previous period, where applicable)

<Tip>The stat cards are the fastest way to check the health of your fan base. If your "New Fans" count is dropping, it might be time to launch a new presave campaign or share your smart link more aggressively.</Tip>

***

## Fan Analytics

Below the stat cards, the analytics section displays deeper insights. This section is powered by the same FanAnalyticsTab component used on the Fans page, but configured for the dashboard "overview" mode.

Depending on your data, you may see:

### Fan Growth Chart

A line or area chart showing fan acquisition over time. The X-axis represents dates (days, weeks, or months depending on the selected range) and the Y-axis represents fan count. This is your most important trend indicator -- a healthy fan base shows consistent upward growth.

### Top Assets

A ranking of your best-performing assets (music releases, merch products, tours) by fan engagement. Helps you see which content is driving the most fan growth.

### Geographic Insights

Where your fans are located. May show top cities or a distribution chart showing which regions have the highest concentration of fans.

### Platform Breakdown

Which platforms your fans are coming from -- Spotify, Apple Music, direct smart link visits, Instagram, SMS, etc.

<Note>Charts require a minimum amount of data to display. If you just started, some charts may appear empty until you have collected enough fan interactions.</Note>

***

## Real-Time Section

Below the analytics section, a labeled section with an orange left border reads **"Real-Time"** with the subtitle "Live fan activity & active campaigns."

This section is split into two columns on desktop (3:2 ratio) and stacks vertically on mobile.

### Recent Activity Feed (Left Column)

The Recent Activity feed shows a live stream of fan actions happening right now. Each entry shows:

* **Fan name or identifier** (e.g., "Sarah J.")
* **Action taken** (e.g., "presaved Midnight Drive", "signed up via SMS", "purchased Luna Waves Tour Tee")
* **Timestamp** (relative, e.g., "2 minutes ago")

The feed updates in real time -- no page refresh needed. When a new fan action occurs, it slides into the top of the list automatically.

<Tip>Keep the Dashboard open on a second screen during a release day or campaign launch. The real-time feed gives you an instant pulse on how things are going.</Tip>

### Active Launches Widget (Right Column)

A compact card showing your top 3 most recent active launches. Each launch entry shows:

* **Launch icon** -- color-coded by type (music note for music, map pin for tours, shopping bag for merch)
* **Launch name** -- the title of the campaign
* **Stage badge** -- the current stage in pill format (Pre-Release, Release, Post-Release)
* **Fan stats** -- number of active fans and active flows
* **Progress bar** -- a gradient bar (orange-to-pink) showing completion percentage

Click any launch to navigate directly to its detail page.

At the top of the widget, a **"View All"** button links to the full Launches page.

If you have no active launches, the widget shows an empty state with a lightning bolt icon and a **"Create your first launch"** link.

***

## Real-Time Updates

The Dashboard uses **real-time data subscriptions** to stay current without requiring page refreshes. Here is what updates automatically:

| Data Point           | Update Mechanism                                     |
| -------------------- | ---------------------------------------------------- |
| Stat card numbers    | Refresh on date range change; real-time for new fans |
| Fan growth chart     | Redraws when new data arrives                        |
| Recent activity feed | New entries slide in immediately via subscription    |
| Active launches      | Fan counters update as fans enter and complete flows |

<Info>This means you can leave the Dashboard open and watch your campaign perform in real time. It is like having a live dashboard at mission control.</Info>

***

## Loading States

When the Dashboard first loads, you will see a clean loading skeleton:

* **Stat cards** show as 6 gray pulsing rectangles in a row
* **Chart area** shows as 3 pulsing rectangles in a row
* **Bottom section** shows as 2 pulsing rectangles side by side

This skeleton appears only during the initial page load while your artist ID is being resolved. Once the artist ID is available, the Fan Analytics component hydrates from a **session storage cache** for an instant first render (no second skeleton), and then fetches fresh data in the background.

***

## Dashboard Best Practices

### Check It Daily

The Dashboard is designed for a quick daily glance. In under 10 seconds you can see:

* How many new fans you gained
* Whether your active campaigns are progressing
* What the most recent fan activity is

### Use the Date Range Strategically

* Use **24h** on launch days to see real-time impact
* Use **7d** for your weekly team meeting
* Use **30d** when reporting to your label or manager
* Use **All Time** when evaluating overall growth

### Share Screenshots With Your Team

The Dashboard is designed to be screenshot-friendly. The stat cards, charts, and activity feed all look clean and professional in screenshots -- perfect for sharing in Slack, email, or social media.

### Keep Launches Active

The Dashboard is most useful when you have active campaigns running. An empty dashboard means no data is flowing. The best artists on Fanaura always have at least one active presave campaign or automation running to keep the fan pipeline moving.

<Warning>An idle Fanaura account collects no data. If your dashboard shows all zeros, it is time to create a presave campaign and share that smart link.</Warning>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Dashboard shows all zeros">
    * You may not have any fans yet. Share your first smart link to start collecting data.
    * Check that your date range is not too narrow (switch to "All Time" to see all data).
    * Verify that you are viewing the correct artist (check the artist switcher in the sidebar).
  </Accordion>

  <Accordion title="Activity feed is empty">
    * No fan actions have occurred in the selected time range.
    * Real-time subscriptions require an active internet connection. Refresh the page if the feed seems stuck.
  </Accordion>

  <Accordion title="Charts are not loading">
    * The analytics component may still be fetching data. Wait a few seconds.
    * If the issue persists, try refreshing the page.
    * Some charts require a minimum amount of data to display (e.g., the growth chart needs at least 2 data points).
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={3}>
  <Card title="Active Launches" icon="rocket" href="/dashboard/active-launches">
    Deep-dive into the active launches widget and full launches page.
  </Card>

  <Card title="Fans" icon="people-group" href="/fans">
    Explore your full fan database with profiles and conversations.
  </Card>

  <Card title="Launches" icon="bullhorn" href="/launches">
    Create and manage your marketing campaigns.
  </Card>
</CardGroup>
