Quickstart - Embeddables Docs

Prerequisites

Node.js 20 or newer

Generate project config

Install and run the Embeddables CLI from your app root:

npm install -g @embeddables/em-cli
em login
em init

This generates your project config with your projectId, forms, and experiments. init also prints your sandbox and live publishable keys — save the one you need for the next step.

Install Core

Every other SDK composes on top of Core, so install it first.

npm install @embeddables/core

pnpm add @embeddables/core

yarn add @embeddables/core

Initialize it

Import the generated config. We strongly recommend letting the CLI manage your project configuration for you, rather than editing it by hand.

React
JavaScript

In your React app (React 18 or newer), wrap it once:

import { EmbeddablesProvider } from '@embeddables/core/react'
import { config } from './embeddables/_dist'

function App() {
  return (
    <EmbeddablesProvider
      config={{
        ...config,
        publishableKey: 'pk_sandbox_<your-key>',
      }}
    >
      <YourApp />
    </EmbeddablesProvider>
  )
}

Use one EmbeddablesProvider at the top of your app. When you add Analytics, Experiments, or Forms, pass modules on this same wrapper (as in each SDK guide) — do not nest a second provider around the same app.

import { initEmbeddables } from '@embeddables/core'
import { config } from './embeddables/_dist'

const embeddables = initEmbeddables({
  ...config,
  publishableKey: 'pk_sandbox_<your-key>',
})

embeddables.getAppUserId()
embeddables.getProjectId()

Add the SDK you actually need

Core alone doesn’t track anything or run experiments — it just resolves identity. Install whichever of the three product SDKs your feature needs:

npm install @embeddables/analytics

npm install @embeddables/experiments

npm install @embeddables/forms

Then continue to that SDK’s guide: Analytics · Experiments · Forms.

​Prerequisites

Prerequisites