Documentation

Ooster Documentation

Everything you need to install, configure, and ship with Ooster — from your first SDK init to enterprise deployment.

DocsGetting Started

Getting Started

Ooster is a premium UX research & product analytics platform. This guide walks you through installing the SDK, configuring your workspace, and running your first UX audit in under five minutes.

app/layout.tsx
TypeScript
// 1. Install
pnpm add @ooster/sdk

// 2. Initialize in your app entry (e.g. app/layout.tsx)
import { OosterProvider } from "@ooster/sdk";

export default function RootLayout({ children }) {
  return (
    <OosterProvider
      apiKey={process.env.NEXT_PUBLIC_OOSTER_KEY!}
      workspace="acme"
      options={{
        captureHeatmaps: true,
        captureReplays: true,
        sampleRate: 1.0,
        respectDNT: true,
      }}
    >
      {children}
    </OosterProvider>
  );
}

Prerequisites

  • Node.js 20+ and pnpm 9+
  • An Ooster workspace (sign up at ooster.app)
  • A project API key from Settings → API Keys
  • A deploy target (Vercel, Netlify, or self-hosted Node)

Install in 4 steps

  1. 1
    Create a workspace

    Sign up at ooster.app and create your first workspace. You'll be guided through a 60-second onboarding flow.

  2. 2
    Install the Ooster SDK

    Add the SDK to your product. It weighs 22KB gzipped and runs entirely client-side, with no PII collected by default.

  3. 3
    Generate an API key

    Head to Settings → API Keys and generate a publishable key. Use it in the SDK init below.

  4. 4
    Run your first audit

    Once the SDK is live, navigate to Projects → your project → Run audit. Results typically land within 2 minutes.

    Command Palette

    Search for a command to run...