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, pageviews, 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 pageviews.

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;
}

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.