# analytics

Analytics tracking for lilith-platform.live.

## Local Packages

Analytics is provided as two local workspace packages (no Verdaccio dependency):

### `@lilith/analytics-client` — `shared/`

Core analytics client, batch queue, device collector, UTM attribution, types.
No React dependency — works in browser and Node.js.

```tsx
import { AnalyticsClient } from '@lilith/analytics-client'
import type { AnalyticsConfig } from '@lilith/analytics-client'
```

### `@lilith/analytics-client-react` — `frontend-client/`

React provider, hooks, and funnel tracking. Depends on `@lilith/analytics-client`.

```tsx
import { AnalyticsProvider, usePageViewTracking } from '@lilith/analytics-client-react'
import { useFunnelEvents, captureEntryReferrer } from '@lilith/analytics-client-react'

function App() {
  return (
    <AnalyticsProvider config={analyticsConfig}>
      <AppRoutes />
    </AnalyticsProvider>
  )
}
```

## Other Analytics Services

- `website-backend-users/` — Lightweight proxy (port 4005) forwarding events to the collector
- `website-frontend-users/` — Analytics dashboard UI (port 5122)

The full analytics infrastructure (collector, query API, TimescaleDB) lives in
`~/Code/@applications/@analytics/` and is started via `./run dev:analytics`.