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

# Analytics

> MixPanel event tracking

# Analytics

The kit uses **MixPanel** for analytics.

## Key File

`lib/mixpanel.ts`

## Usage

```typescript theme={null}
import { track, Events } from '@/lib/mixpanel';

// Predefined event
track(Events.PAYWALL_VIEWED);

// With properties
track(Events.PURCHASE_COMPLETED, {
  product_id: 'monthly',
  price: 9.99,
});

// Custom event
track('feature_used', { feature: 'export' });
```

## Pre-defined Events

| Event                  | When                    |
| ---------------------- | ----------------------- |
| `app_opened`           | App launches            |
| `onboarding_started`   | Onboarding begins       |
| `onboarding_completed` | Onboarding finished     |
| `paywall_viewed`       | Paywall shown           |
| `purchase_completed`   | Subscription successful |

## Best Practices

* Use `snake_case` for event names
* Include relevant context in properties
* Track funnel steps consistently