lilith-platform.live/codebase/@features/analytics/README.md
2026-04-08 11:57:24 -07:00

42 lines
1.3 KiB
Markdown

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