@dropfix/sdk

The DropFix browser SDK — auto-instruments your SaaS to track user events, build an event model with AI, and detect churn signals before users leave.

Quick start

Step 1. Sign up at dropfix.in and copy your public key (pk_live_...)

Step 2. Drop the SDK into your app. Pick one:

Script tag (any framework)

<script src="https://cdn.jsdelivr.net/npm/@dropfix/sdk/dist/dropfix.js"></script>
<script>
  DropFix.init({ key: "pk_live_YOUR_KEY" });
</script>

npm / yarn / pnpm

npm install @dropfix/sdk

import { DropFix } from "@dropfix/sdk";

DropFix.init({ key: "pk_live_YOUR_KEY" });

That's it. DropFix now auto-tracks every click, form submission, page view, and API call in your app.

Identify your users

Tie events to real users so DropFix can detect churn signals on a per-user basis:

DropFix.identify("user_123", {
  name: "Jane Doe",
  email: "[email protected]",
  plan: "growth",
  mrr: 49,
  signup_date: "2025-06-01",
  trial_ends: "2025-06-22"
});

Important: call identify() on every page load (e.g. in your root layout or auth provider), not just on login. This ensures returning users are recognized without re-logging in.

For server-side HMAC verification (recommended for production), see the identity verification docs.

Track custom events

DropFix auto-tracks most things, but you can also send custom events:

DropFix.track("checkout_completed", {
  plan: "growth",
  mrr: 49,
  trial: false
});

What gets tracked automatically

• Every click on a button / link (with smart context: button text, nearby heading, surrounding component)
• Every form submission
• Page views (including SPA route changes)
• API calls your app makes (URL, status, duration)
• Session duration and engagement signals

Versioning

The CDN URL https://cdn.jsdelivr.net/npm/@dropfix/sdk/dist/dropfix.js always serves the latest stable version. We guarantee backward compatibility — you'll never need to update your snippet.

Bundle size

~4 KB gzipped. Loaded async, doesn't block page render.

License

MIT