Documentation

SDK

The core library (@tacko/telemetry-core) exposes init, event and error helpers, screen/session tracking, and identity. Platform packages wrap the same config for Next.js, Nuxt, Node, and React Native.

init(config)

Required: ingestUrl (your API base URL) and app (a string that groups data in the dashboard). Optional: platform, environment, release, batchInterval, batchSize.

Full example (after init)

import { init, trackEvent, trackError, screen, identify } from "@tacko/telemetry-core";

init({
  ingestUrl: "https://your-api.example.com",
  app: "my-app",
});

trackEvent("button_click", { id: "submit" });
trackError(new Error("Something broke"), { page: "/checkout" });
screen("/home");
identify("user-123");

Identity and anonymous ID

The SDK generates a stable anonymous device id on first init() and sends it (and the SDK version) with every payload. When you call identify(userId), the same anonymous id is still sent so the backend can link pre-login activity to the user. In the dashboard, Identity shows the user id when set, otherwise the anonymous id.

App name

The app value identifies your application in filters and lists. You do not register apps in the UI—once you send at least one event or error with a name, it appears everywhere that supports app filtering.

Next steps

Follow a platform guide for install steps, or open the dashboard docs to learn how data appears in the UI.