Once your app is live, a question naturally follows: is anyone actually using it? And if so, who, from where, and how often? Without answers, you are building in the dark — unable to tell whether a new feature made a difference, whether your audience is growing, or whether anyone outside your immediate circle has discovered your app. Analytics gives you that visibility.
Caffeine tracks visitor activity on your live app and displays the data in a simple analytics panel — visitor counts, session length, geographic breakdown, and more. No setup required; it activates automatically when you publish.
Analytics is available on Plus and Pro plans.
What metrics are shown
The analytics panel shows six metrics for the time period you select:
- Unique visitors — the number of distinct people who visited your app
- Sessions — the total number of visits (one person visiting three times counts as three sessions)
- Pageviews — the total number of pages loaded across all visits
- Average views per visit — pageviews divided by sessions
- Visit duration — total time visitors have spent in your app
- Countries — a breakdown of where your visitors are located, showing up to six countries individually with visitor counts
Time ranges
You can view data for the last 7 days, last 30 days, or last 90 days. There is no custom date range or all-time view.
How to open analytics
There are two ways to get to the analytics panel:
- From App Settings (the gear icon in the chat panel): the main settings screen has three buttons — Publish, Analytics, and More. Click Analytics.
- From the project menu in the chat header: click the
···button next to your project name and select View analytics.
Requirements
Your app must be live. Analytics tracking is only active for published apps — it does not apply to drafts. If your app hasn't been published yet, the analytics panel shows a prompt to publish first.
You need a Plus or Pro subscription. On Basic and Starter plans, the analytics panel shows an upgrade prompt instead of data.
Tracking starts from your first live deployment on a qualifying plan. There is no retroactive data — if you upgrade and then publish, tracking begins from that point forward. Historical visits before the plan upgrade are not recorded.
How tracking works
When you publish your app, Caffeine automatically injects an analytics tracking script into your app. No setup is required — it happens as part of the deployment process. The tracking is powered by Umami, a privacy-focused analytics platform.
Frequently asked questions
Does analytics track draft visits or only live visits?
Only live visits. The tracking script is only injected into live deployments. Draft usage is not tracked.
Do I need to add any code to my app to enable tracking?
No. Caffeine injects the tracking script automatically when you publish. There is nothing to configure.
Is user data or personal information collected?
Analytics tracks aggregate visit data — counts, duration, and country. No personally identifiable information is collected and no cookies are set. The underlying platform (Umami) is designed to be privacy-respecting.
Why don't I see referrer or page-level data?
The current analytics panel shows aggregate metrics and a country breakdown. Per-page views, referrer sources, browser types, and device data are not currently displayed in the Caffeine dashboard, even though the underlying platform supports them. More detailed breakdowns may be added in future.
Can I see analytics data older than 90 days?
No. The panel supports up to 90 days. There is no all-time view or custom date range.
Does analytics work with custom domains?
Yes. Once your custom domain is connected and your app is live at that domain, analytics tracks visits to both the custom domain and the default Caffeine URL.