| SDK Version | Schema Version | API Version | Status |
|---|
0.8.x | 0.1.x | v1 | Current |
| Browser | Minimum Version | Notes |
|---|
| Chrome | 90+ | Full support |
| Firefox | 90+ | Full support |
| Safari | 15+ | Full support |
| Edge | 90+ | Full support (Chromium-based) |
| iOS Safari | 15+ | Full support |
| Chrome Android | 90+ | Full support |
The SDK requires these browser APIs:
| API | Used For | Fallback |
|---|
fetch | Playbook sync, server-derived context, event delivery (not used in local_only) | Required — no fallback |
localStorage | Decision cache, interaction state | In-memory fallback |
sessionStorage | Session state | In-memory fallback |
JSON.parse/stringify | Data serialization | Required — no fallback |
Promise | Async operations | Required — no fallback |
| Dependency | Minimum Version | Recommended |
|---|
| React | 18.0 | 19.x |
| React DOM | 18.0 | 19.x |
The SDK uses React hooks (useState, useEffect, useContext, useRef). React 17 and below are not supported.
| Package | Runtime | Minimum Version |
|---|
@revturbine/sdk (web) | Browser | — |
| Server SDK (Node.js) | Node.js | 22.13 |
| Tool | Support | Notes |
|---|
| Vite | ✅ | Recommended |
| Next.js | ✅ | App Router and Pages Router |
| webpack | ✅ | Version 5+ |
| Parcel | ✅ | Version 2+ |
| esbuild | ✅ | Used internally for bundling |
| Feature | react | snippet | iframe |
|---|
RevTurbineProvider | ✅ | — | — |
| React hooks | ✅ | — | — |
| Drop-in slot components | ✅ | — | — |
| Headless controllers | ✅ | ✅ | — |
| Custom slot types | ✅ | — | — |
| Theming | ✅ | ✅ | ✅ |
| Event tracking | ✅ | ✅ | ✅ |
| localStorage persistence | ✅ | ✅ | ✅ |
Decisions are evaluated inside your app in every mode. The modes differ in where the Playbook comes from and where telemetry goes.
| revturbine_server | local_only | custom_endpoints |
|---|
| Decision evaluation (entitlements, placements, caps) | In your app | In your app | In your app |
| Playbook source | RevTurbine control plane, cached in the SDK, re-checked about once a minute | Bundled with your app | Your endpoints |
| Server-derived context (plan, trial, payment state) | ✅ via client session | Supplied by your app | Your endpoints |
| Usage and events | Sent to RevTurbine ingest | Kept locally | Your endpoints |
| Playbook changes | Live, without a deploy | Redeploy | Your endpoints |
| Cap enforcement | ✅ Client | ✅ Client | ✅ Client |
| TypeScript Version | Support |
|---|
| 5.0+ | ✅ Full support |
| 4.9 | ⚠️ May work, not tested |
| 4.8 and below | ❌ Not supported |
The SDK ships with .d.ts type declarations. All public APIs are fully typed.
Bundle size depends on the entry point, bundler, and imported components. The
SDK is tree-shakeable, so measure the exact pinned release in your production
build; this page does not publish estimates that can drift from the package.
