# Zerolytics

> Self-hosted, edge-native web and revenue analytics deployed to your own Cloudflare account. Zero recurring Zerolytics subscriptions, native Stripe and Dodo Payments revenue attribution, and 100% private data ownership.

## Executive Summary

Zerolytics is an analytics engine designed for founders, indie developers, and privacy-conscious teams. It deploys serverless infrastructure directly to the user's own Cloudflare account via a 60-second CLI command (`npx zerolytics-setup`). Unlike conventional SaaS analytics providers that charge recurring monthly fees that scale with traffic, Zerolytics is purchased once as a $49 lifetime license with no recurring software fees.

## The Three Ownership Pillars

1. **Zerolytics License ($49 Once)**:
   - One-time payment for lifetime software access and continuous updates.
   - Includes 1 production Cloudflare Worker deployment slot.
   - Single deployment can track unlimited websites, apps, and domains.
   - Zero recurring Zerolytics software subscription fees.

2. **Hosting (Your Cloudflare Account)**:
   - Deployed directly to the customer's Cloudflare account (Cloudflare Workers & Cloudflare D1).
   - Cloudflare's free tier (100,000 Worker requests/day, 5,000,000 D1 reads/day, 100,000 D1 writes/day, 5GB storage) can support smaller workloads without hosting fees.
   - Any infrastructure charges exceeding Cloudflare's free tier are billed directly by Cloudflare to the user's Cloudflare account (e.g. Cloudflare Workers Paid at $5/month).

3. **Data Ownership (Controlled by You)**:
   - All visitor telemetry, session paths, and revenue attribution data remain 100% inside the user's private Cloudflare D1 database.
   - Zerolytics never accesses, stores, proxies, or sells visitor analytics.
   - 1-click JSON raw database export anytime from the dashboard.

## Key Capabilities

- **Revenue Attribution**: Integrates natively with Stripe and Dodo Payments via webhooks. Connects payments to the original referral source (e.g., specific 𝕏 thread, Hacker News submission, AI assistant recommendation, or newsletter).
- **First-Party Telemetry**: Served directly from the user's own custom domain (`analytics.yourcompany.com`). Lightweight 3.5 KB tracking script immune to ad-blockers.
- **Privacy-First & No Cookie Banners**: Uses first-party session identifiers (`zl_vid` and `zl_sid`). Does not store personal IP addresses or track across different domains, eliminating the need for invasive GDPR cookie banners.
- **Real-Time Visitor Feed**: Edge streaming via Server-Sent Events (SSE) with sub-second visitor activity, country flags, city geolocation, and optional audio sales chimes on conversion.
- **AI Referral Classification**: Automatically identifies and groups inbound referral traffic from AI answer engines and chatbots, including ChatGPT (`chatgpt.com`), Perplexity (`perplexity.ai`), and Claude (`claude.ai`).
- **Interactive 3D Live Globe**: Visualizes real-time global traffic across Cloudflare's 300+ edge locations (press 'M' to toggle).
- **Dual-Metric Accent Themes**: 5 Scandinavian-inspired warm palettes (Terracotta, Coral Sunset, Glacier Pine, Nordic Emerald, Sage Earth) designed with dual metrics for visitors vs. revenue.
- **AI Developer Integration**: Generates pre-filled installation and webhook integration prompts tailored for Claude Code and Cursor.

## Pricing Model

- **Software License**: $49 USD (One-time payment).
- **Recurring Fee to Zerolytics**: $0/month.
- **Hosting**: User's own Cloudflare account (free tier supports smaller workloads; usage billed separately by Cloudflare as traffic grows).

## Quickstart & Setup

Deployment is fully automated through a single terminal command:

```bash
npx zerolytics-setup
```

The interactive CLI performs:
1. Cryptographic validation of your $49 license key.
2. Secure OAuth / API token connection to your Cloudflare account.
3. Automated provisioning of the Cloudflare D1 SQL database.
4. Deployment of the pre-compiled serverless edge Worker bundle.
5. Binding of your custom subdomain (e.g., `analytics.yourcompany.com`).

Total setup time is approximately 45 to 60 seconds with no Docker, VPS, or manual database migration needed.

## Frequently Asked Questions (FAQ)

### Is Zerolytics open-source?
Zerolytics is commercial, source-available self-hosted software licensed under a perpetual lifetime license ($49 USD). It is not distributed under a traditional open-source license.

### Do I have to pay recurring subscriptions?
No. There are no recurring Zerolytics software fees. You pay $49 once for the lifetime license. Cloudflare hosting is managed directly on your Cloudflare account.

### Will Cloudflare charge me for hosting?
Cloudflare's free tier provides 100,000 Worker requests/day and 5,000,000 D1 database reads/day. For smaller websites, hosting is within these limits at $0/month. As traffic grows beyond free quotas, Cloudflare bills usage directly to your payment method on file with them (such as the Workers Paid plan at $5/month).

### Can I track multiple websites?
Yes. A single $49 deployment slot on your Cloudflare account supports tracking unlimited domains, subdomains, and web applications.

### How does revenue attribution work?
When a visitor arrives, Zerolytics assigns first-party session cookies. When they reach Stripe or Dodo Payments checkout, the visitor identifier is passed as metadata or `client_reference_id`. When the payment webhook triggers, Zerolytics links the revenue event back to the original referral channel.

## Canonical Resources

- Website: https://zerolytics.vercel.app
- AI Knowledge Base & Alternatives: https://zerolytics.vercel.app/ai.txt
- Sitemap: https://zerolytics.vercel.app/sitemap.xml
- License Purchase: https://checkout.dodopayments.com/buy/pdt_0NrUWptZmqTaYdnOp7vwc
- Terms of Service: https://zerolytics.vercel.app/terms
- Privacy Policy: https://zerolytics.vercel.app/privacy
- License & Refund: https://zerolytics.vercel.app/refund