nanalytics-tracker

Privacy-respecting analytics tracker using Context VM and Nostr.

Installation

Script Tag (easiest)

<script
  src="https://unpkg.com/nanalytics-tracker/dist/index.global.js"
  data-site-uuid="YOUR_SITE_UUID"
  data-cvm-pubkey="YOUR_CVM_PUBKEY"
></script>

NPM

npm install nanalytics-tracker

import { init, trackPageView } from 'nanalytics-tracker';

init({
  siteUuid: 'YOUR_SITE_UUID',
  cvmPubkey: 'YOUR_CVM_PUBKEY',
  onTrack: (success) => console.log('Tracked:', success)
});

// For SPAs, manually track route changes:
trackPageView('/new-route');

Configuration

| Option | Required | Description | |--------|----------|-------------| | siteUuid | Yes | Your site's unique identifier | | cvmPubkey | Yes | Context VM server public key (64 hex chars) | | relays | No | Custom relay URLs (defaults to contextvm relays) | | onTrack | No | Callback fired after each track attempt |

What's Tracked

• pagePath - Current page pathname
• deviceType - desktop, mobile, or tablet

Features

• Auto-tracks on page load
• Debounces duplicate page views (5s window)
• Fire-and-forget (doesn't block page load)
• End-to-end encrypted via NIP-44

License

MIT