The React wrapper ships a useCustomerLog hook. It builds the client once per component and returns a stable log function you can call from event handlers.

terminal

npm install @customerlog/react

signup-button.tsx

import { useCustomerLog } from "@customerlog/react"; function SignupButton() { const { log } = useCustomerLog({ apiKey: "cl_xxx" }); const handleSignup = async () => { await log({ channel: "signups", title: "User signed up", message: "Came in via Google OAuth", metadata: { user_id: "usr_123", source: "google" }, notify: true, }); }; return <button onClick={handleSignup}>Complete signup</button>; }

Call log() from an event handler or effect, not during render. Each component creates its own client — reuse the hook in a shared module if you log from many places.

Base URL

All SDKs POST to https://event.customerlog.byorello.space/ by default. To self-host or point at a different environment, pass baseUrl in the client config (JS/TS, Dart, Python, Go, PHP, and Rust).

SDK Implementations

Packages

Framework guides

React

Base URL

We care about your privacy