Welcome to Pulsora Documentation#

Pulsora is a privacy-first analytics platform that helps you understand your users without compromising their privacy. No cookies, no personal data collection, just actionable insights.

What is Pulsora?#

Pulsora provides three powerful packages that work together to give you complete analytics coverage:

@pulsora/core - Browser-based analytics tracking
@pulsora/revenue - Server-side revenue attribution
@pulsora/react - React hooks for seamless integration

Key Features#

🔒 Privacy-First Design#

No cookies - GDPR compliant by default
No personal data - Server-side anonymous visitor identification
No consent banners - Track users respectfully

⚡ Lightning Fast#

~2KB bundle size - Won't slow down your site
Automatic retries - Reliable data collection
Edge-optimized - Global performance

📊 Complete Analytics#

Pageview tracking - Automatic SPA support
Custom events - Track any user interaction
Revenue attribution - Connect payments to campaigns
User journeys - Understand conversion paths

Quick Start#

Get started with Pulsora in just 5 minutes:

1. Install the Package#

npm install @pulsora/core

2. Initialize Tracking#

import { Pulsora } from '@pulsora/core';

const pulsora = new Pulsora();
pulsora.init({
  apiToken: 'your-api-token',
});

3. Track Your First Event#

// Automatic pageview tracking
pulsora.pageview();

// Custom event tracking
pulsora.event('button_click', {
  button: 'signup',
  location: 'header',
});

That's it! You're now tracking analytics privately and efficiently.

Package Overview#

Core Package#

The foundation of Pulsora analytics. Handles all browser-based tracking including pageviews, events, and user identification.

Learn more about @pulsora/core →

Revenue Package#

Server-side revenue tracking with full attribution. Perfect for tracking purchases, subscriptions, and other monetary events.

Learn more about @pulsora/revenue →

React Package#

Idiomatic React integration with hooks for pageview tracking, events, and user identification.

Learn more about @pulsora/react →

Integration Guides#

Learn how to integrate Pulsora with your favorite frameworks and payment processors:

Use Cases#

SaaS Applications#

Track user journeys from landing page to conversion. Understand which campaigns drive the most valuable customers with full revenue attribution.

Example: Connect Stripe payments to marketing campaigns, measure CAC and LTV, optimize spending.

Content Websites#

Measure engagement without compromising user privacy. No cookie banners, no consent forms, just clean analytics.

Example: Track which articles drive signups, measure reading time, understand content performance.

E-commerce#

Attribute revenue to traffic sources. Understand the complete customer journey from first visit to purchase.

Example: Track product views, cart additions, and purchases with Stripe/Paddle integration.

Developer Tools#

Privacy-compliant analytics for your users. Cloud-hosted, no infrastructure management needed.

Example: Embed Pulsora in your SaaS product for usage analytics without privacy concerns.

Why Choose Pulsora?#

⚡ Simple & Fast#

One line of code to get started
~2KB bundle won't impact performance
Edge-optimized CDN for global speed
Volume-based pricing - pay only for what you use

🛡️ Privacy Compliant#

GDPR, CCPA, PECR compliant out of the box
No cookies or personal data collection
No consent banners required
Server-side visitor IDs respect user privacy

👨‍💻 Developer Friendly#

Full TypeScript support with type definitions
Comprehensive documentation with real examples
Framework integrations for React, Next.js, Remix
Cloud-native - no infrastructure management

Getting Started Paths#

Choose your path based on your needs:

🚀 I Want to Start Quickly#

5-Minute Quickstart - Get tracking in minutes
Core Package Installation - Browser tracking
First Event - Track custom events

⚛️ I'm Using React#

React Package Overview - Learn about hooks
React Installation - Set up provider
Next.js Guide - Full Next.js integration

💰 I Need Revenue Tracking#

Revenue Package Overview - Understand attribution
Stripe Integration - Connect payments
Revenue API - Complete reference

Common Tasks#

Track a Button Click → Custom Events
Track Subscriptions → Revenue Webhooks
Configure Attribution → Attribution Windows
Debug Issues → Debugging Guide
Optimize Performance → Performance Tips
Handle Errors → Error Handling

Need Help?#

📚 API Reference - Complete REST API docs
📖 Core API - Browser SDK reference
📧 support@pulsora.co - Email support
🔒 Privacy & Compliance - How we handle data

Ready to Get Started?#

5-Minute Quickstart → Installation Guide →