@froggsense/browser

Lightweight browser SDK for FroggSense analytics.

This package is currently a workspace package and has not been published to the public npm registry yet. External apps should use the hosted script SDK until @froggsense/browser is published.

pnpm --filter @froggsense/browser build

import { froggsense } from "@froggsense/browser";

froggsense.init({
  projectKey: "YOUR_PROJECT_KEY",
  apiBaseUrl: "https://api.froggsense.com",
});

froggsense.track("button_clicked", {
  buttonName: "Get Started",
  location: "Hero Section",
});

The SDK sends public browser intake requests to:

• POST /v1/tracker/events
• POST /v1/tracker/errors

Core methods:

• froggsense.init(options)
• froggsense.track(eventName, properties, options)
• froggsense.page(page, properties)
• froggsense.identify(userId, traits)
• froggsense.error(error, context, options)
• froggsense.captureError(error, context, options)
• froggsense.trackScrollDepth(depth, page)
• froggsense.flush()

Agent integration guide

This package ships an agent-ready Markdown guide for coding agents:

pnpm --filter @froggsense/browser generate:agent-md

The generated file is AGENT_INTEGRATION.md. Copy it into another project or paste the prompt section into your coding agent to wire FroggSense safely.