Directories
¶
| Path | Synopsis |
|---|---|
|
Package alert defines threshold alerts on event metrics — "fire when <event> count over the last N hours is above/below a threshold".
|
Package alert defines threshold alerts on event metrics — "fire when <event> count over the last N hours is above/below a threshold". |
|
Package alias joins anonymous pre-login activity to the logged-in user — identity stitching.
|
Package alias joins anonymous pre-login activity to the logged-in user — identity stitching. |
|
Package api serves the single-binary HTTP surface: event ingestion + the server-rendered dashboard.
|
Package api serves the single-binary HTTP surface: event ingestion + the server-rendered dashboard. |
|
Package audit is the change log every real product needs — a record of the operator actions that mutate config or data (account changes, key create/revoke, retention, data clears).
|
Package audit is the change log every real product needs — a record of the operator actions that mutate config or data (account changes, key create/revoke, retention, data clears). |
|
Package botua identifies crawler/bot user agents so autocaptured web traffic ($pageview/$click) doesn't inflate every report.
|
Package botua identifies crawler/bot user agents so autocaptured web traffic ($pageview/$click) doesn't inflate every report. |
|
Package brief computes the morning "what to fix" digest: the pulse (last N days vs the N before), the per-product portfolio split, and the verdict engine's findings.
|
Package brief computes the morning "what to fix" digest: the pulse (last N days vs the N before), the per-product portfolio split, and the verdict engine's findings. |
|
Package cohort defines reusable user groups — "users who did checkout", "users from Hacker News who activated" — that you define once and apply across every report.
|
Package cohort defines reusable user groups — "users who did checkout", "users from Hacker News who activated" — that you define once and apply across every report. |
|
Package defined implements retroactive, zero-code events — the Heap wedge.
|
Package defined implements retroactive, zero-code events — the Heap wedge. |
|
Package demo seeds a realistic dataset so `smolanalytics demo` shows a populated, beautiful dashboard with zero setup — the 60-second "oh" moment.
|
Package demo seeds a realistic dataset so `smolanalytics demo` shows a populated, beautiful dashboard with zero setup — the 60-second "oh" moment. |
|
Package engagement computes the standard engagement reports — lifecycle (new/returning/resurrected/dormant) and stickiness (DAU/WAU/MAU) — that every product-analytics tool ships.
|
Package engagement computes the standard engagement reports — lifecycle (new/returning/resurrected/dormant) and stickiness (DAU/WAU/MAU) — that every product-analytics tool ships. |
|
Package event defines the core analytics event — the single unit everything (funnels, retention, trends) is computed from.
|
Package event defines the core analytics event — the single unit everything (funnels, retention, trends) is computed from. |
|
Package exportlink mints one-time download links for the full raw event export (GET /export/<token>) — "give me my data" from the editor without dumping millions of rows through a conversation.
|
Package exportlink mints one-time download links for the full raw event export (GET /export/<token>) — "give me my data" from the editor without dumping millions of rows through a conversation. |
|
Package funnel computes ordered conversion funnels — the headline feature: of the users who did step 1, how many went on to do step 2, then 3, and where do they drop off.
|
Package funnel computes ordered conversion funnels — the headline feature: of the users who did step 1, how many went on to do step 2, then 3, and where do they drop off. |
|
Package geo resolves visitor IPs to a country code using the DB-IP Lite free database (db-ip.com, CC BY 4.0 — the dashboard credits it wherever countries render).
|
Package geo resolves visitor IPs to a country code using the DB-IP Lite free database (db-ip.com, CC BY 4.0 — the dashboard credits it wherever countries render). |
|
Package goal stores named conversion goals — "what counts as success on this site" — defined once, reusable everywhere.
|
Package goal stores named conversion goals — "what counts as success on this site" — defined once, reusable everywhere. |
|
Package groups computes account-level (B2B) analytics — aggregate by a group property (company, account_id, team) instead of by user.
|
Package groups computes account-level (B2B) analytics — aggregate by a group property (company, account_id, team) instead of by user. |
|
Package gsc integrates Google Search Console: the search queries that bring people to your site, next to what they did after arriving — the one report neither GA nor the privacy tools unify well.
|
Package gsc integrates Google Search Console: the search queries that bring people to your site, next to what they did after arriving — the one report neither GA nor the privacy tools unify well. |
|
Package importer brings history over from another tool so day one here isn't a zero dashboard.
|
Package importer brings history over from another tool so day one here isn't a zero dashboard. |
|
Package insight produces the proactive "what's broken / what to look at" digest — the verdict founders actually want instead of a dashboard.
|
Package insight produces the proactive "what's broken / what to look at" digest — the verdict founders actually want instead of a dashboard. |
|
Package insights persists saved reports — the "pin this report" feature that turns ad-hoc Explore into a dashboard you open every morning.
|
Package insights persists saved reports — the "pin this report" feature that turns ad-hoc Explore into a dashboard you open every morning. |
|
Package instrument turns "the agent instruments your app" from a pasted prompt into a real capability.
|
Package instrument turns "the agent instruments your app" from a pasted prompt into a real capability. |
|
Package mcp exposes the analytics engine over the Model Context Protocol so the user connects smolanalytics to THEIR OWN Claude / Cursor / Claude Code and asks questions in plain English — their model calls these tools, we never call a model ourselves (no API keys, no inference cost on our side).
|
Package mcp exposes the analytics engine over the Model Context Protocol so the user connects smolanalytics to THEIR OWN Claude / Cursor / Claude Code and asks questions in plain English — their model calls these tools, we never call a model ourselves (no API keys, no inference cost on our side). |
|
Package paths computes user flows — "what do users do after event X?" — the Flows / Pathfinder / Paths report.
|
Package paths computes user flows — "what do users do after event X?" — the Flows / Pathfinder / Paths report. |
|
Package query is the segmentation backbone: filter events by their properties and break them down (group by) a property.
|
Package query is the segmentation backbone: filter events by their properties and break them down (group by) a property. |
|
Package retention computes cohort retention — the other core product-analytics primitive: group users by the day they first showed up, then track what % come back on day 1, 2, ...
|
Package retention computes cohort retention — the other core product-analytics primitive: group users by the day they first showed up, then track what % come back on day 1, 2, ... |
|
Package settings holds the operational config every real product needs — project name, timezone, managed API keys, and the session-signing secret — persisted as a single JSON file (atomic rewrite), separate from event data.
|
Package settings holds the operational config every real product needs — project name, timezone, managed API keys, and the session-signing secret — persisted as a single JSON file (atomic rewrite), separate from event data. |
|
Package share issues revocable read-only share links — show your traffic to a cofounder or investor without giving them a login.
|
Package share issues revocable read-only share links — show your traffic to a cofounder or investor without giving them a login. |
|
Package store is the data layer.
|
Package store is the data layer. |
|
blob
Package blob is object storage as one small interface: whole-object Put/Get/List/ Delete.
|
Package blob is object storage as one small interface: whole-object Put/Get/List/ Delete. |
|
file
Package file is a durable store.Store: an append-only JSONL event log that replays into memory on open.
|
Package file is a durable store.Store: an append-only JSONL event log that replays into memory on open. |
|
memory
Package memory is an in-memory store.Store: enough to run the full engine in tests and the zero-setup CLI demo.
|
Package memory is an in-memory store.Store: enough to run the full engine in tests and the zero-setup CLI demo. |
|
segment
Package segment is the scale tier: a durable hot append-log that seals into immutable, time-bounded, compressed columnar segments on a Blob backend (local disk now, S3/R2 next).
|
Package segment is the scale tier: a durable hot append-log that seals into immutable, time-bounded, compressed columnar segments on a Blob backend (local disk now, S3/R2 next). |
|
Package trackplan stores the intended instrumentation — the events (and their properties) an app MEANS to track.
|
Package trackplan stores the intended instrumentation — the events (and their properties) an app MEANS to track. |
|
Package trends computes time-series — how many times an event happened per day (optionally unique users), the third core analysis primitive alongside funnels and retention.
|
Package trends computes time-series — how many times an event happened per day (optionally unique users), the third core analysis primitive alongside funnels and retention. |
|
Package web composes the one-glance web-analytics view — live visitors, top pages, referrers, UTM sources, device split — from $pageview events.
|
Package web composes the one-glance web-analytics view — live visitors, top pages, referrers, UTM sources, device split — from $pageview events. |
|
Package webhook delivers outbound notifications to operator-configured URLs (used by alerts and the daily digest).
|
Package webhook delivers outbound notifications to operator-configured URLs (used by alerts and the daily digest). |
Click to show internal directories.
Click to hide internal directories.