Ooster Documentation
Everything you need to install, configure, and ship with Ooster — from your first SDK init to enterprise deployment.
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.
// 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
- 1Create a workspace
Sign up at ooster.app and create your first workspace. You'll be guided through a 60-second onboarding flow.
- 2Install the Ooster SDK
Add the SDK to your product. It weighs 22KB gzipped and runs entirely client-side, with no PII collected by default.
- 3Generate an API key
Head to Settings → API Keys and generate a publishable key. Use it in the SDK init below.
- 4Run your first audit
Once the SDK is live, navigate to Projects → your project → Run audit. Results typically land within 2 minutes.