Spoar

What it replaces

Know what people do without handing their data to a third party.

Use it when you want product analytics on a site or app but do not want cookies, consent banners or a vendor in the loop. Create one client, list your events once, and add plugins only for what you need.

• Events are typed per name, so track calls and their props autocomplete and fail to compile when they drift.
• Cookie-free, honours Do Not Track and Global Privacy Control, and batches sends with retries and sendBeacon on page hide.
• Plugins for web vitals, errors, scroll depth, clicks, forms and experiments, each under a kilobyte, so an app only ships what it uses.

Quick start

Start with one small integration.

1import { createAnalytics } from '@spoar/sdk'2import { errors, speedInsights } from '@spoar/sdk/plugins'3import type { Events } from './events'45export const analytics = createAnalytics<Events>({6  project: 'my-site',7  key: 'pk_live_...',8  endpoint: '/_ra',9  plugins: [speedInsights(), errors()]10})1112analytics.track('signup', { plan: 'pro' })

API examples

Start with one call. Add the pieces when you need them.

1import { AnalyticsProvider } from '@spoar/sdk/react'2import { Analytics } from '@spoar/sdk/next'3import { analytics } from './analytics'45export default function RootLayout({ children }) {6  return (7    <html lang="en">8      <body>9        <AnalyticsProvider client={analytics}>10          <Analytics />11          {children}12        </AnalyticsProvider>13      </body>14    </html>15  )16}

1import { createServerAnalytics } from '@spoar/sdk/server'23const serverAnalytics = createServerAnalytics<Events>({4  secret: process.env.RA_SECRET,5  endpoint: 'https://api.analytics.remcostoeten.nl'6})78export async function POST(request: Request) {9  await createUser()10  await serverAnalytics.track('signup', { plan: 'pro' }, { request })11  return Response.json({ ok: true })12}

createAnalytics()

Creates the browser client with project, key, endpoint and plugins.

analytics.track()

Sends a typed custom event with its props.

createServerAnalytics()

Sends events from API routes, webhooks or cron jobs with a secret.

createProxy()

Serves a same-origin endpoint so events get past ad blockers.