How rybbit-io/rybbit works
Rybbit is a privacy-focused web and product analytics application. Site users explore collected traffic and product behavior through dashboards, reports, maps, user profiles, and analysis tools; administrators manage organizations and sites. The client exposes feature-specific screens and API hooks, while the sampled server code shows session-replay ingestion, session assignment, and replay retrieval with optional object storage. README capabilities such as funnels, goals, retention, errors, and Web Vitals are represented, but their backend wiring is not established by the excerpts.
Main entry points: useAnalyticsQuery.ts Analytics context · r2StorageService.ts Replay object storage · sessionReplayIngestService.ts Replay ingestion · sessionReplayQueryService.ts Replay retrieval
Components 28
Analytics experience
- Site overview
client/src/app/[site]/main/page.tsx - Events
client/src/app/[site]/events/page.tsx - Live maps
client/src/app/[site]/globe/page.tsx - Replay browser
client/src/app/[site]/replay/page.tsx - Error tracking
client/src/app/[site]/errors/page.tsx - Web Vitals
client/src/app/[site]/performance/page.tsx
Product analysis
- Custom dashboards
client/src/app/[site]/dashboards/page.tsx - Funnels
client/src/app/[site]/funnels/page.tsx - Goals
client/src/app/[site]/goals/page.tsx - User journeys
client/src/app/[site]/journeys/page.tsx - Retention
client/src/app/[site]/retention/page.tsx - User profiles
client/src/app/[site]/users/page.tsx - Custom queries
client/src/app/[site]/query/page.tsx
Client API
- Analytics context
client/src/api/analytics/useAnalyticsQuery.ts - Analytics hooks
client/src/api/analytics/hooks/useGetOverview.ts - Analytics endpoints
client/src/api/analytics/endpoints/overview.ts - Custom query hook
client/src/api/analytics/hooks/useCustomQuery.ts - Custom query endpoint
client/src/api/analytics/endpoints/customQuery.ts
Replay services
- Replay ingestion
server/src/services/replay/sessionReplayIngestService.ts - Session assignment
server/src/services/sessions/sessionsService.ts - Replay retrieval
server/src/services/replay/sessionReplayQueryService.ts - Replay object storage
server/src/services/storage/r2StorageService.ts
Administration
- Admin console
client/src/app/admin/page.tsx - Account settings
client/src/app/settings/account/components/ApiKeyManager.tsx
Other components
- Site user
- ClickHouse
- Cloudflare R2
- Redis sessions
Connections 31
- Site user → Site overview: views
- Site user → Events: explores
- Site user → Live maps: explores
- Site user → Replay browser: opens
- Site user → Error tracking: reviews
- Site user → Web Vitals: reviews
- Site user → Custom dashboards: builds
- Site user → Funnels: analyzes
- Site user → Goals: configures
- Site user → User journeys: analyzes
- Site user → Retention: analyzes
- Site user → User profiles: inspects
- Site user → Custom queries: queries
- Site overview → Analytics context: gets context
- Events → Analytics context: gets context
- Live maps → Analytics context: gets context
- Replay browser → Analytics context: gets context
- Analytics context → Analytics hooks: provides context
- Analytics hooks → Analytics endpoints: requests data
- Custom queries → Custom query hook: runs query
- Custom query hook → Custom query endpoint: invokes
- Replay ingestion → Session assignment: updates session
- Session assignment → Redis sessions: gets or creates
- Replay ingestion → ClickHouse: inserts events
- Replay ingestion → Replay object storage: stores batches
- Replay object storage → Cloudflare R2: writes objects
- Replay retrieval → ClickHouse: queries metadata
- Replay retrieval → Replay object storage: fetches batches
- Replay object storage → Cloudflare R2: reads objects
- Admin console → Analytics context: uses client APIs
- Account settings → Analytics context: uses client APIs