🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Outlit SDK

by @leo-paz

Use when integrating Outlit tracking into web, server, native, or desktop apps; adding SDK event tracking, identity, consent, activation, billing, visitor tr...

πŸ“‹ Tips & Best Practices

No browser events

1. Confirm the public env var prefix is correct and exposed to the client bundle. 2. Confirm provider/init runs once at app startup and wraps the app. 3. If autoTrack: false, call enableTracking() after consent. 4. Check Network for /api/i/v1//events. 5. Check console warnings such as tracking not enabled, already initialized, or multiple instances.

Events not linked to users

  • Prefer OutlitProvider user, useOutlitUser, or setUser() for auth state.
  • Send both email and userId when available.
  • Include customerId for account/workspace-scoped products.
  • Browser identity links visitor history; server identity does not replace browser identity.
  • For native/device history, reuse the same persistent fingerprint before and after login.
  • Server events missing

  • Use publicKey, not privateKey.
  • Use eventName, not event.
  • Provide at least one of email, userId, fingerprint, or customerId to track().
  • identify() needs email or userId.
  • Always await outlit.flush() before serverless handlers return.
  • Non-retryable ingest errors stop automatic retries until restart; fix credentials/config instead of waiting.
  • Activation missing or delayed

  • Call activation after identity is set.
  • In browsers, user.activate() can queue until setUser()/identify() provides identity, but the queue is bounded.
  • Do not use deprecated engaged/inactive calls; send product activity with track().
  • View on ClawHub
    TERMINAL
    clawhub install outlit-sdk

    πŸ§ͺ Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    πŸ” Can't find the right skill?

    Search 60,000+ AI agent skills β€” free, no login needed.

    Search Skills β†’