Quickstart: Web (npm)

Install the package

npm install @founderhq/events

Initialize once, at your app's entry point

import { founderhq } from "@founderhq/events";

founderhq.init("fhq_pk_XXXX");

founderhq is a shared client. Import it anywhere. Calling init a second time does nothing, so a hot reload is safe.

From here on, page views, page leaves, sessions, clicks, rage clicks, dead clicks, outbound clicks, scroll depth, and Core Web Vitals are captured for you. Single-page navigations count as page views.

Next.js App Router, or any framework that renders on the server? Put the call in a client component and render it once in your root layout.

"use client";

import { useEffect } from "react";
import { founderhq } from "@founderhq/events";

export function FounderHqAnalytics() {
  useEffect(() => {
    founderhq.init("fhq_pk_XXXX");
  }, []);
  return null;
}

Using a cookie banner?

FounderHQ records everything from the first page view. If your site asks visitors for consent first, start in the pending state and call consent when the visitor accepts:

founderhq.init("fhq_pk_XXXX", { consent_default: "pending" });

// Later, when the visitor accepts your banner:
founderhq.consent("granted");

While consent is pending, FounderHQ counts page views without cookies and records nothing else: identify and your own events are ignored. FounderHQ remembers the visitor's answer for 180 days. See Consent and privacy.

Identify the person when they sign in

founderhq.identify("user_8421", {
  email: "jane@acme.com",
  plan: "pro",
});

Pass your own stable user ID, not an email. FounderHQ merges the visitor's anonymous history into that contact.

Call founderhq.reset() when the person signs out, so the next visitor on that browser starts clean.

Capture your first event

founderhq.capture("trial.started", { plan: "pro" });

Use lowercase names you will still understand in six months. Event names that start with $ are reserved.