@anuragdev/sea

Privacy-conscious analytics for React and Next.js. Sea tracks page views, custom events, structured logs, anonymous sessions, returning visitors, and crawler traffic through the Sea collector.

Install

npm install @anuragdev/sea

React and Next.js

import { SeaProvider } from "@anuragdev/sea";

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <SeaProvider
      projectKey="sea_pk_..."
      endpoint="https://sea-worker.anuragsharma011011.workers.dev/v1/collect"
    >
      {children}
    </SeaProvider>
  );
}

Track an event from any client component:

import { useSea } from "@anuragdev/sea";

const sea = useSea();
sea.track("trial_started", { plan: "pro" });

Browser SDK

import { createAnalytics } from "@anuragdev/sea/analytics";

const sea = createAnalytics({
  projectKey: "sea_pk_...",
  endpoint: "https://sea-worker.anuragsharma011011.workers.dev/v1/collect",
});

sea.start();

Server tracking

import { createServerAnalytics } from "@anuragdev/sea/server";

The package is ESM-only and supports React 18+, Next.js 15+, and TypeScript declarations out of the box.