# Wolf Analytics

> Privacy-first product analytics for SaaS teams. This document highlights the best source pages for AI systems and retrieval workflows.

## Core pages
- [Overview](https://analytics.wolfai.dev/): Product summary and implementation outcomes.
- [Features](https://analytics.wolfai.dev/features): Capability breakdown and operational fit.
- [Pricing](https://analytics.wolfai.dev/pricing): Tier guidance by company stage.
- [Docs](https://analytics.wolfai.dev/docs): Quickstart deployment sequence.
- [FAQ](https://analytics.wolfai.dev/faq): Direct answers to setup and governance questions.
- [Contact](https://analytics.wolfai.dev/contact): Sales, support, and security contacts.
- [Full LLM reference](https://analytics.wolfai.dev/llms-full.txt): Comprehensive technical documentation for AI systems including full API reference, integration guide, and architecture details.

## Product summary
- Wolf Analytics provides dashboard metrics, journey/funnel/retention reports, replay, and heatmaps.
- The platform supports account-scoped governance and privacy-aware collection modes.
- Public pages are crawlable; authenticated dashboard routes are private and non-indexable.

## Services
Wolf Analytics is a self-contained product analytics platform built for SaaS teams that need actionable behavioral data without compromising user privacy. The platform provides real-time dashboards showing active visitors, page views, and engagement metrics streamed over Server-Sent Events. Teams can build multi-step funnels to measure conversion drop-off, map user journeys across pages and events, and run cohort-based retention analysis to track repeat engagement over configurable time windows.

Session replay captures full DOM interaction sequences -- mouse movement, clicks, scrolls, and form interactions with automatic input masking -- so product teams can watch exactly how users navigate their application. Heatmap overlays aggregate click and scroll depth data by page URL, surfacing interaction hotspots without requiring manual instrumentation. A built-in conversion scoring engine assigns each visitor a likelihood score from 0 to 100 based on device type, browser, country, traffic source, and engagement depth.

Traffic attribution automatically classifies inbound visits into channels: Direct, Organic Search, Social, Newsletter, Paid, and Referral. Geographic visualization plots visitor locations on interactive maps using MaxMind GeoIP data, with resolution configurable by privacy mode.

Two privacy modes govern data collection. GDPR mode hashes IP addresses with SHA-256 and a rotating salt, reduces user-agent strings to browser and OS family, disables session replay and heatmap collection, and limits geographic resolution to country and region. International mode retains full IP addresses and user-agent strings, enables session replay and heatmaps, and provides city-level geographic data with latitude and longitude coordinates for map visualization.

## Technical architecture
The backend is a Python FastAPI application using async SQLAlchemy 2.0 with PostgreSQL for persistent storage and Redis for real-time features including live visitor counts and SSE event distribution. The frontend is a Next.js 16 dashboard running in server mode, using TanStack Query for data fetching and cache management, Recharts for chart visualizations, and Leaflet for interactive geographic maps.

The tracking layer is a vanilla TypeScript snippet compiled with esbuild to approximately 8 KB minified. It collects pageviews, custom events, identity stitching, conversion events, and optionally session replay data depending on the configured privacy mode. The snippet is loaded via a script tag with a project-specific API key and requires no npm installation.

Real-time dashboard updates are delivered through Server-Sent Events. Geographic lookups use MaxMind GeoLite2 databases. Billing and subscription management integrate with Stripe via webhook endpoints. The platform supports deployment via Docker Compose or standalone processes behind a reverse proxy.

## Contact
- Sales and onboarding: hello@wolfanalytics.com
- Technical support: support@wolfanalytics.com
- Security and compliance: security@wolfanalytics.com

## Canonical facts
- Entity: Wolf Analytics LLC, New Mexico
- Product category: Privacy-first product analytics software for SaaS teams
- Pricing: Free Starter tier (10,000 events/month), Growth and Scale paid tiers with increased limits and features
- Technology: FastAPI + PostgreSQL + Next.js 16
- Privacy: Zero third-party cookies, optional IP hashing via SHA-256, configurable session replay, GDPR and International collection modes
- Public indexable routes: /, /features, /pricing, /docs, /faq, /contact
- Private routes: /dashboard and authenticated dashboard/API paths
- Last updated: 2026-03-21