Skip to content

Home

Tidemill

Open-source subscription analytics — compute and visualize MRR, ARR, LTV, retention, churn, and more from your billing data.

Architecture

Implementation plan for the analytics engine.

  • Overview — event-driven system design with Kafka
  • Events — internal event schema and Kafka topics
  • Database — PostgreSQL schema, ER diagram, and rationale
  • Connectors — webhook translators for Stripe, Lago, Kill Bill
  • Metrics — metric plugin system with self-managed tables
  • API — FastAPI endpoints
  • Development - Local development
  • Deployment — Docker Compose on Hetzner, path to Kubernetes
  • Testing — Stripe Test Clocks, seed scripts, webhook forwarding

Research

Background research and competitive analysis that informed the product direction.

Market & Models

Pricing & Billing

Competitive Landscape

Product