@indiebob/tracker

bob.page(overrides?)

Track a page view. Call this on every page load and SPA navigation.

bob.page()                            // Auto-detects path, title, referrer
bob.page({ path: '/pricing' })        // Override path
bob.page({ title: 'Pricing Page' })  // Override title

Auto-detected: URL path, page title, referrer, UTM parameters, device type.

bob.track(event, properties?)

Track a custom event.

bob.track('signup_started')
bob.track('trial_activated', { plan: 'pro' })
bob.track('feature_used', { feature: 'csv_export', count: 3 })
bob.track('checkout_completed', { revenue: 29.00, currency: 'USD', plan: 'pro-monthly' })

• event — string, required. Max 256 characters. Use snake_case by convention.
• properties — plain object, optional. Values must be JSON-serializable.

bob.identify(userId, traits?)

Associate the current anonymous visitor with a known user ID. Call this after login or signup.

bob.identify('user_123', {
  email: '[email protected]',
  name: 'Jane Smith',
  plan: 'pro',
  createdAt: '2026-01-15',
})

• userId — string, required. Your internal user ID. Never pass PII directly as the userId.
• traits — plain object, optional. Include email to enable Stripe attribution linking.

After identify(), all subsequent events are linked to this userId until the session ends.

bob.revenue(data)

Track a revenue event. Use alongside Stripe webhooks for complete attribution.

bob.revenue({
  amount: 29.00,        // Required. Positive number.
  currency: 'USD',      // Optional. Default: 'USD'. ISO 4217 code.
  plan: 'pro-monthly',  // Optional. Your plan name.
  type: 'new',          // Optional. 'new' | 'renewal' | 'upgrade' | 'downgrade'
})

Privacy Controls

bob.optOut()       // Stop all tracking. Clears all stored identifiers.
bob.optIn()        // Re-enable tracking.
bob.isOptedOut()   // Returns boolean.

Debug helpers

bob.getAnonymousId()  // Returns the current anonymous ID
bob.getSessionId()    // Returns the current session ID
bob.getConfig()       // Returns a read-only copy of the config
bob.flush()           // Force-send all queued events immediately

— URL Intent Detection

When bob.page() is called, the SDK checks the URL path against known patterns (multilingual: EN, ES, FR, DE, PT, IT, NL) and fires the corresponding event:

— Signup vs Login Detection

When bob.identify() is called:

• First call for this visitor fires signup (new user)
• Subsequent calls fire login (returning user)

Uses a localStorage flag — no server round-trip needed.

— Form Submit Detection

On signup, login, and checkout pages, form submissions are automatically tracked:

• signup_submit — form submitted on a signup page
• login_submit — form submitted on a login page
• checkout_submit — form submitted on a checkout page

— Outbound Click Tracking

Clicks on links pointing to external domains automatically fire outbound_click with { url, hostname } properties.

— Data Attribute Tracking

Add data-ib-event to any element for zero-JS custom event tracking:

<button data-ib-event="add_to_cart" data-ib-plan="pro" data-ib-price="29">
  Add to Cart
</button>

This fires track('add_to_cart', { plan: 'pro', price: '29' }) on click. All data-ib-* attributes (except data-ib-event) become event properties.

— Customizing Auto-Detection

Override the default URL patterns or disable specific features:

const bob = IndieBob.init({
  projectId: 'proj_abc123',
  autoDetect: {
    // Custom URL patterns — strings or RegExp (override defaults)
    signupPaths: ['/my-signup-page'],         // string: matched via path.includes()
    checkoutPaths: [/\/buy|\/purchase/i],     // RegExp: matched via .test()

    // Disable specific features
    outboundClicks: false,
    formSubmit: false,
    dataAttributes: false,
  },
})

Set autoDetect: false to disable all auto-detection entirely.

— Vue / Nuxt

import { IndieBobPlugin } from '@indiebob/tracker/vue'

app.use(IndieBobPlugin, { projectId: 'proj_abc123def456ghij' })

Then in any component:

import { useTracker } from '@indiebob/tracker/vue'

const bob = useTracker()
bob.track('button_clicked', { button: 'cta_hero' })

Nuxt plugin (plugins/tracker.client.ts):

import { IndieBobPlugin } from '@indiebob/tracker/vue'

export default defineNuxtPlugin((nuxtApp) => {
  nuxtApp.vueApp.use(IndieBobPlugin, {
    projectId: useRuntimeConfig().public.trackerProjectId,
  })
})

Page views auto-track on vue-router navigation.

— React / Next.js

import { IndieBob } from '@indiebob/tracker'
import { useEffect } from 'react'

// Initialize once at app root
const bob = IndieBob.init({ projectId: 'proj_abc123def456ghij' })

// In a page component or layout — call bob.page() on every navigation
useEffect(() => {
  bob.page()
}, [pathname])

— Vanilla JS (Script Tag)

<script src="https://assets.indiebob.com/tracker/latest/indiebob.min.js"></script>
<script>
  const bob = IndieBob.init({ projectId: 'proj_abc123def456ghij' })
  bob.page()
</script>

— Server-Side (Node.js)

import { IndieBob } from '@indiebob/tracker/server'

const bob = IndieBob.initServer({ projectId: 'proj_abc123def456ghij' })
bob.track('server_event', { source: 'cron_job' })