SDK Overview

The Databuddy SDK provides framework-specific components, helper functions, server-side tracking, and a vanilla JavaScript library for tracking analytics events. Choose your preferred integration method.

SDK Version: 2.0.0+ | Package: @databuddy/sdk | CDN: cdn.databuddy.cc

Installation

# Using bun (recommended)
bun add @databuddy/sdk

# Using npm
npm install @databuddy/sdk

For vanilla JavaScript, no installation needed - load directly from CDN.

Quick Start

React / Next.js

Component and hooks for React applications

Nuxt

First-class Nuxt module for script injection, SPA navigation, and optional error tracking

Vue

Component and composables for Vue applications

Vanilla JavaScript

CDN script for any website without dependencies

Node.js / Server

Server-side tracking for APIs, webhooks, and background jobs

Core Features

Tracker Helpers

Helper functions: track, flush, getAnonymousId, getTrackingParams

Feature Flags

Control feature rollouts and A/B testing in React and Vue

Server Flags

Server-side feature flag evaluation for Node.js

DevTools

Local overlay for events, identity, queues, diagnostics, and flags

Configuration

All configuration options across platforms

Import Paths

The SDK is organized into submodules for tree-shaking:

Import	Description
`@databuddy/sdk`	Core tracker helpers (track, flush, etc.)
`@databuddy/sdk/react`	React component and hooks
`@databuddy/sdk/vue`	Vue component and composables
`@databuddy/nuxt`	Nuxt module for Databuddy tracking
`@databuddy/sdk/node`	Node.js server-side SDK

Example: React/Next.js

import { Databuddy } from "@databuddy/sdk/react";
import { track } from "@databuddy/sdk";

// In your root layout
export default function RootLayout({ children }) {
return (
  <html>
    <body>
      <Databuddy
        clientId={process.env.NEXT_PUBLIC_DATABUDDY_CLIENT_ID!}
        trackWebVitals
        trackErrors
      />
      {children}
    </body>
  </html>
);
}

// In any component
function SignupButton() {
return (
  <button onClick={() => track("signup_clicked", { source: "header" })}>
    Sign Up
  </button>
);
}

Example: Node.js

import { Databuddy } from "@databuddy/sdk/node";

const client = new Databuddy({
apiKey: process.env.DATABUDDY_API_KEY!,
websiteId: process.env.DATABUDDY_WEBSITE_ID,
enableBatching: true
});

await client.track({
name: "api_call",
properties: { endpoint: "/api/users", method: "GET" }
});

await client.flush(); // Important in serverless!

TypeScript Support

The SDK is fully typed with excellent TypeScript support:

import { track, type DatabuddyTracker } from "@databuddy/sdk";
import type { DatabuddyConfig } from "@databuddy/sdk/react";
import type { CustomEventInput } from "@databuddy/sdk/node";

Getting Started

Quick setup guide and basic configuration

API Reference

Direct HTTP API for custom implementations

Dashboard Guide

Navigate your analytics dashboard