Open-source, privacy-first web analytics platform — featuring real-time dashboards, session replays,
heatmaps, funnels, revenue tracking, behavioral automations, and AI-powered natural language queries.
Quick Start · Features · Tracking · @seentics/ui · Self-Hosting · Contributing
|
|
|
|
Seentics is a fully self-hosted analytics platform. It gives you everything you need to understand your visitors and improve your product — without cookies, fingerprinting, or sharing data with third parties.
You own your data. It runs on your infrastructure. Deploy in minutes with Docker.
- Seentics AI — ask anything about your data in plain English; AI generates SQL and renders charts across analytics, revenue, replays, heatmaps, funnels, and automations (
⌘K) - Real-time analytics — live visitor map, active pages, and traffic as it happens
- Session replays — watch full recordings with rage-click and JS error detection
- Heatmaps — click maps, scroll depth, and captured page screenshots
- Funnels — multi-step conversion analysis with drop-off rates
- Revenue tracking — orders, AOV, ARPU, and UTM channel attribution
- Custom events — track any action with typed properties and filtering
- Goals — page visit, custom event, or CSS selector click conversions
- Behavioral automations — trigger webhooks or emails based on visitor actions
- Path analysis — visualize how users move between pages
- Privacy-first — no cookies, no fingerprinting, fully self-hosted
| Layer | Technology |
|---|---|
| Backend API | Bun · Hono · Drizzle ORM (TypeScript) |
| Frontend | Next.js 15 · Tailwind CSS · shadcn/ui |
| Database | PostgreSQL 16 |
| Object Storage | S3-compatible (MinIO in Docker Compose) |
| Session Replays | rrweb |
Requirements: Docker and Docker Compose
git clone https://github.com/Seentics/seentics.git
cd seentics
docker compose up -d --buildOpen http://localhost:3000 to access the dashboard.
The API is available at http://localhost:8080/api/v1.
After creating a website in the dashboard, add to your <head>:
<script
defer
src="https://your-seentics-domain.com/trackers/seentics.js"
data-website-id="YOUR_WEBSITE_ID"
></script>Pageviews are tracked automatically. The website ID is the UUID shown in your dashboard.
// Simple event
seentics.track('signup_click')
// Event with properties
seentics.track('purchase', {
value: 49.99,
currency: 'USD',
order_id: 'ORD-1234',
plan: 'pro',
})
// Identify a user (optional)
seentics.identify({ email: 'user@example.com', plan: 'pro' })Call seentics.track('purchase', { ... }) on your checkout confirmation page:
seentics.track('purchase', {
value: 99.00,
currency: 'USD',
order_id: 'ORD-5678', // used for deduplication
product_name: 'Pro Plan', // shows in Product breakdown
user_type: 'new', // 'new' | 'returning'
})Attribution is resolved automatically from the visitor's session UTM parameters using last-non-direct touch.
Create goals in Settings → Goals:
| Type | How it fires |
|---|---|
| Page visit | Visitor hits a URL path (e.g. /thank-you) |
| Custom event | Your code calls seentics.track('event_name') |
| CSS selector | Visitor clicks a matching element (e.g. #signup-btn) |
seentics/
├── core/ # Bun + Hono API — analytics ingest, replays, heatmaps
│ ├── routes/ # API route handlers
│ ├── services/ # Business logic
│ ├── lib/ # Shared utilities
│ └── db/ # Drizzle schema + migrations
│
├── web/ # Next.js dashboard
│ ├── public/
│ │ └── trackers/ # seentics.js tracker script
│ └── src/
│ ├── app/
│ │ └── websites/[websiteId]/
│ │ ├── page.tsx # Analytics overview
│ │ ├── realtime/ # Live dashboard
│ │ ├── heatmaps/ # Heatmaps
│ │ ├── replays/ # Session replays
│ │ ├── funnels/ # Funnels
│ │ ├── revenue/ # Revenue & orders
│ │ ├── events/ # Custom events
│ │ ├── paths/ # Path analysis
│ │ ├── automations/ # Behavioral automations
│ │ └── settings/ # Goals, team, API keys, alerts
│ ├── components/ # Reusable UI components
│ ├── lib/ # API clients
│ └── hooks/ # Custom React hooks
│
├── ui/
│ └── blocks/ # @seentics/ui — embeddable React UI blocks (MIT)
│
└── docker-compose.yml
Drop Seentics analytics charts and widgets directly into your own React app — no dashboard login required.
npm install @seentics/uiimport { SeenticsProvider, TrafficChart, AnalyticsSummary, HeatmapViewer, SessionReplayPlayer } from '@seentics/ui'
export default function MyDashboard() {
return (
<SeenticsProvider apiKey="sk_..." baseUrl="https://your-seentics-domain.com">
<AnalyticsSummary siteId="site_abc" days={30} />
<TrafficChart siteId="site_abc" days={30} />
<HeatmapViewer siteId="site_abc" pageUrl="/pricing" />
</SeenticsProvider>
)
}Available blocks:
| Block | Description |
|---|---|
<AnalyticsSummary /> |
Pageviews, visitors, bounce rate, session duration cards |
<TrafficChart /> |
Daily traffic timeseries chart |
<TopPages /> |
Top pages by pageviews |
<TopSources /> |
Referrer / UTM source breakdown |
<GoalConversions /> |
Goal completion rates |
<FunnelChart /> |
Multi-step funnel with drop-off |
<RealtimeCounter /> |
Live visitor count |
<HeatmapViewer /> |
Click and scroll heatmap overlay |
<SessionReplayPlayer /> |
Embedded rrweb session replay player |
Source lives in ui/blocks/. Licensed under MIT — use it in any project.
docker compose up -d --buildStarts PostgreSQL, MinIO, the Bun API, and the Next.js app with hot reload.
Copy and configure the environment variables, then run behind a reverse proxy (nginx, Caddy, Traefik) with HTTPS.
cp .env.example .env
# Edit .env with your values
docker compose -f docker-compose.prod.yml up -d --buildSee DEPLOYMENT.md for a full production setup guide.
| Variable | Description |
|---|---|
DATABASE_URL |
PostgreSQL connection string |
JWT_SECRET |
Secret key for session tokens |
GLOBAL_API_KEY |
Internal service-to-service auth key |
S3_ENDPOINT |
S3-compatible endpoint (MinIO URL in Docker) |
S3_BUCKET |
Bucket name for replay and heatmap storage |
S3_ACCESS_KEY / S3_SECRET_KEY |
S3 credentials |
S3_PUBLIC |
Public base URL for presigned asset access |
CORS_ALLOWED_ORIGINS |
Comma-separated browser origins allowed to call the API |
TRUST_PROXY |
Set true when behind a reverse proxy to trust forwarded IP headers |
ENVIRONMENT |
production | development |
Browser / App
│
├─ Dashboard ──▶ Next.js :3000
│ │
└─ Tracker ───────────┤
▼
Bun API :8080
/api/v1/...
│ │
PostgreSQL MinIO (S3)
(events, meta) (replays, heatmaps)
The tracker and dashboard both talk to the core API. Analytics events and metadata are stored in PostgreSQL. Session replay chunks and heatmap screenshots are stored in S3-compatible object storage.
Contributions are welcome — bug reports, feature requests, docs improvements, and pull requests.
- Fork the repository
- Create a feature branch:
git checkout -b feat/my-feature - Commit your changes:
git commit -m 'feat: add my feature' - Push and open a pull request
Please open an issue first for significant changes so we can discuss the approach.
Seentics is licensed under the GNU AGPL v3.0.
You may self-host freely. Any modifications must be released under the same license.
The @seentics/ui package is separately licensed under the MIT License.
Built by the Seentics team · Report an issue