Installation

Web SDK (React)

Install

@revturbine/sdk is published to the public npm registry — no auth, token, or registry configuration required.

npm

npm install @revturbine/sdk

pnpm

pnpm add @revturbine/sdk

yarn

yarn add @revturbine/sdk

Peer Dependencies

The web SDK requires:

Package	Version
react	>=18.0.0
react-dom	>=18.0.0

TypeScript

The SDK ships with full TypeScript declarations. No additional @types/ packages are needed.

Recommended tsconfig.json settings:

{
  "compilerOptions": {
    "strict": true,
    "moduleResolution": "bundler",
    "esModuleInterop": true,
    "jsx": "react-jsx"
  }
}

Headless / Non-React

The same @revturbine/sdk package includes a headless entry point for use without React:

import { initRevTurbine } from '@revturbine/sdk/headless';

This import tree-shakes React dependencies. See the Headless API guide for usage patterns with vanilla JS, Vue, Svelte, and Angular.

Server-Side

Server SDKs are available for backend entitlement checks and placement resolution:

Language	Package
Node.js	@revturbine/sdk (headless entry)
Python	revturbine (PyPI)

Note

Both server SDKs are published — @revturbine/sdk (npm) and revturbine (PyPI) — and produce byte-identical decisions for the same config and user context.

CLI

The @revturbine/cli package manages your RevTurbine configuration (plans, entitlements, placements) and change sets from the terminal — verify, diff, upload, and deploy an ExportedConfig.

npm install -g @revturbine/cli
revturbine --help

Or run it without installing:

npx @revturbine/cli verify ./exported_config.json

Authenticate

The CLI signs in with a browser device-flow login — there are no API keys or environment variables to set. Authorize it once per machine:

revturbine login

This opens your browser to approve the device, then stores a tenant-scoped token at ~/.revturbine/credentials.json (file mode 0600). Run revturbine status to confirm you’re connected — or revturbine signup to create an account from the terminal first. Commands that only read or validate a local file, like verify, need no login.

See the CLI reference for the full command surface (verify, diff, upload, deploy, export, status, and the change-set lifecycle).

Supported Runtimes

Runtime	Minimum Version
Node.js	20+
Modern browsers	Chrome 90+, Firefox 90+, Safari 15+, Edge 90+
React	18.0+
TypeScript	5.0+

Next Steps

• Quickstart — render your first placement
• Runtime modes — choose server, custom endpoints, or local-only