@typedtrack/next

Next.js App Router bindings ("use client" AnalyticsProvider boundary, useAnalytics) for typetrack.

Install

bun add typetrack @typedtrack/next

Requires React 19+ and Next.js 14/15/16.

Usage

// app/providers.tsx
"use client";
import { createAnalytics } from "typedtrack";
import { AnalyticsProvider, AnalyticsPageView } from "@typedtrack/next";

const analytics = createAnalytics();

export function Providers({ children }: { children: React.ReactNode }) {
  return (
    <AnalyticsProvider analytics={analytics}>
      <AnalyticsPageView />
      {children}
    </AnalyticsProvider>
  );
}

// any client component
"use client";
import { useAnalytics } from "@typedtrack/next";

function SignupButton() {
  const analytics = useAnalytics();
  return <button onClick={() => analytics.track("Signup Completed", { plan: "pro" })}>Sign up</button>;
}

<AnalyticsPageView /> fires .page() automatically on client-side route change (App Router has no built-in route-change event) — drop it once inside your provider tree, no extra <Suspense> setup required.

See docs/README.md for the full documentation index.