How to Track Feature Usage in Your SaaS

// First time a user does something meaningful
async function onFirstProjectCreated(user: User, projectName: string) {
  await logit.now("features", {
    event: "First project created",
    description: `${user.email} created "${projectName}"`,
    icon: "📁",
    notify: false,
    tags: { plan: user.plan, feature: "project-create" },
    metadata: { userId: user.id, email: user.email, projectName },
  });
}

async function trackActivation(user: User, milestone: string) {
  await logit.now("activation", {
    event: `Activation: ${milestone}`,
    description: `${user.email} hit milestone: ${milestone}`,
    icon: "⚡",
    notify: false,
    tags: { milestone, plan: user.plan },
    metadata: { userId: user.id, email: user.email },
  });
}

// Call when user hits each activation step
await trackActivation(user, "created-first-project");
await trackActivation(user, "sent-first-event");
await trackActivation(user, "invited-teammate");

// When a user hits a usage threshold — worth a notification
if (user.eventCount === 1000) {
  await logit.now("features", {
    event: "Power user: 1000 events",
    description: `${user.email} sent their 1000th event`,
    icon: "🚀",
    notify: true,
    tags: { milestone: "1000-events", plan: user.plan },
    metadata: { userId: user.id, email: user.email, count: user.eventCount },
  });
}