How swetrix/swetrix-api works
Swetrix is a privacy-first web analytics platform with Cloud and Community editions. Its principal workflow is visitor tracking followed by analytics ingestion and dashboard queries; the README also documents sessions, funnels, errors, performance, replay, and product-management capabilities. Source excerpts establish several service dependencies, but not the full ingestion or web-client wiring, so those links are omitted or marked unverified.
Main entry points: project.controller.ts Project API · analytics.service.ts Analytics queries · auth.service.ts Authentication · mailer.service.ts Email delivery
Components 25
Tracking and analytics
- JavaScript tracker
packages/tracker-js/src/Lib.ts - Analytics API
backend/apps/cloud/src/analytics/analytics.controller.ts - Analytics queries
backend/apps/cloud/src/analytics/analytics.service.ts - Bot detection
backend/apps/cloud/src/analytics/bot-detection.service.ts - Session replays
backend/apps/cloud/src/analytics/session-replay-export.service.ts
Projects and insights
- Project API
backend/apps/cloud/src/project/project.controller.ts - Project management
backend/apps/cloud/src/project/project.service.ts - Project records
backend/apps/cloud/src/project/entity/project.entity.ts - Project sharing
backend/apps/cloud/src/project/entity/project-share.entity.ts - Goals
backend/apps/cloud/src/goal/entity/goal.entity.ts
Accounts and access
- User accounts
backend/apps/cloud/src/user/user.service.ts - User records
backend/apps/cloud/src/user/entities/user.entity.ts - Authentication
backend/apps/cloud/src/auth/auth.service.ts - Action tokens
backend/apps/cloud/src/action-tokens/action-tokens.service.ts - Token records
backend/apps/cloud/src/action-tokens/action-token.entity.ts - Email delivery
backend/apps/cloud/src/mailer/mailer.service.ts - Email templates
backend/apps/cloud/src/mailer/letter.ts
Product capabilities
- Alerts and notifications
backend/apps/cloud/src/alert/alert.service.ts - Feature flags
backend/apps/cloud/src/feature-flag/feature-flag.service.ts - A/B experiments
backend/apps/cloud/src/experiment/experiment.service.ts - Revenue analytics
backend/apps/cloud/src/revenue/revenue.service.ts - Ask AI
backend/apps/cloud/src/ai/ai.service.ts
Shared infrastructure
- ClickHouse
backend/apps/cloud/src/common/integrations/clickhouse.ts - Application logging
backend/apps/cloud/src/logger/logger.service.ts
Other components
- Site visitor
Connections 22
- Site visitor → JavaScript tracker: uses
- JavaScript tracker → Analytics API: sends events
- Analytics API → Analytics queries: queries
- Analytics queries → Bot detection: checks bots
backend/apps/cloud/src/analytics/analytics.service.ts - Analytics queries → ClickHouse: queries
backend/apps/cloud/src/analytics/analytics.service.ts - Project API → Project management: manages projects
backend/apps/cloud/src/project/project.controller.ts - Project API → Analytics queries: requests analytics
backend/apps/cloud/src/project/project.controller.ts - Project API → User accounts: checks accounts
backend/apps/cloud/src/project/project.controller.ts - Project API → Action tokens: creates tokens
backend/apps/cloud/src/project/project.controller.ts - Project API → Email delivery: sends email
backend/apps/cloud/src/project/project.controller.ts - Project management → ClickHouse: reads usage
backend/apps/cloud/src/project/project.service.ts - Authentication → User accounts: manages users
backend/apps/cloud/src/auth/auth.service.ts - Authentication → Action tokens: uses tokens
backend/apps/cloud/src/auth/auth.service.ts - Authentication → Email delivery: sends email
backend/apps/cloud/src/auth/auth.service.ts - User accounts → User records: persists users
backend/apps/cloud/src/user/user.service.ts - Authentication → Project management: accesses projects
backend/apps/cloud/src/auth/auth.service.ts - Action tokens → Token records: stores tokens
backend/apps/cloud/src/action-tokens/action-tokens.service.ts - Email delivery → Email templates: uses templates
- Session replays → ClickHouse: exports replay data
- Alerts and notifications → Email delivery: notifies by email
- A/B experiments → Analytics queries: uses metrics
- Feature flags → A/B experiments: supports testing