# Installation

The Chat Embed SDK renders Cherry chat inside your web app. It's published on npm and works in any modern bundler (Vite, Next.js, Webpack) or straight from a `<script>` tag.

> **Tip:** Want to see it before installing? The [live embed builder](https://cherry.fun/chat-embed-example/) runs the chat in your browser with no signup or backend, and its "Show the integration snippet" button gives you copy-paste code to drop in.

## npm (recommended)

```bash
npm install @cherrydotfun/chat-embed-sdk
```

The package ships ESM, CommonJS, and TypeScript types, no `@types` package needed.

```ts
import { CherryEmbed } from '@cherrydotfun/chat-embed-sdk';
```

Other package managers work the same way:

```bash
pnpm add @cherrydotfun/chat-embed-sdk
bun add @cherrydotfun/chat-embed-sdk
yarn add @cherrydotfun/chat-embed-sdk
```

## Script tag (no build step)

For a plain HTML site, load the package from npm via jsDelivr. The global build exposes `window.CherryEmbedSDK`:

```html
<script src="https://cdn.jsdelivr.net/npm/@cherrydotfun/chat-embed-sdk@0.1.5/dist/index.global.js"></script>
<script>
  const chat = new window.CherryEmbedSDK.CherryEmbed({ /* config */ });
  chat.mount();
</script>
```

> **Tip:** Pin the version in the CDN URL (`@0.1.5`) so a future release can't change behavior under you. With npm, your lockfile already does this.

## Mobile (React Native / Flutter)

The SDK is browser-only, so it can't run directly in a mobile JS runtime. On mobile you run it inside a WebView on a small host page and bridge wallet signing to the native layer: see [React Native & Flutter](https://portal.cherry.fun/docs/embed/mobile.md).

## Requirements

- A Cherry **embed** (created in your [project's](https://portal.cherry.fun/dashboard) **Chat embeds** section), it gives you the `appId`.
- Your site's origin added to the embed's **Allowed origins**.
- A mount target: an element on your page (for inline embeds) or nothing (for floating widgets).

## Next steps

- [Configuration](https://portal.cherry.fun/docs/embed/configuration.md), every option `CherryEmbed` accepts.
- [Authentication](https://portal.cherry.fun/docs/embed/authentication.md), wallet-only vs. backend-signed tokens.