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