> ## Documentation Index
> Fetch the complete documentation index at: https://developer.suki.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Web SDK Installation

> Install Suki.js Web SDK in your JavaScript or React application

<Callout title="Updates" color="orange" icon="bell">
  **From Web SDK `v3.0.0+`:** You need `@suki-sdk/core` for `SukiAuthManager` for authenticating the Suki Web SDK.
</Callout>

<Tip>
  **Already using `@suki-sdk/js` or `@suki-sdk/react`?**

  These packages already include the **Dictation** and **Form filling** clients. You do not need to install `@suki-sdk/dictation`, `@suki-sdk/dictation-react`, `@suki-sdk/form-filling`, or `@suki-sdk/form-filling-react` separately.

  Import them from the Web SDK package instead of installing them separately:

  <CodeGroup title="Import Dictation or Form Filling from the Web SDK">
    ```javascript @suki-sdk/js theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
    import { DictationClient } from "@suki-sdk/js";
    import { FormFillingClient } from "@suki-sdk/js";
    ```

    ```tsx @suki-sdk/react theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
    import { Dictation, DictationClient, DictationProvider, useDictation } from "@suki-sdk/react";
    import { FormFilling, FormFillingClient, FormFillingProvider, useFormFilling } from "@suki-sdk/react";
    ```
  </CodeGroup>

  * Install a standalone Dictation or Form filling package only if you want that feature without the rest of the Web SDK.

  * Refer to the [Dictation overview](/web-sdk/dictation-overview) and [Form filling overview](/web-sdk/form-filling-overview) guides for feature-specific usage.
</Tip>

We have modularized the Suki Web SDK into **framework-specific packages** so you only need to install the one that fits your environment.

The SDK is built for modern JavaScript and requires an [ES6 compatible browser](https://caniuse.com/?search=es6).

## Prerequisites

For the rest of this documentation, we will assume you have completed the [Partner onboarding](/documentation/get-started/partner-onboarding) process and that:

* You have received your `partnerId` from Suki

* Your partner configuration includes a valid [JWKS endpoint](/documentation/how-to/partner-authentication)

* Your authentication token contains the correct user identifier (e.g., `sub`, `email`)

## Install the package

### For plain JavaScript

Use the `@suki-sdk/js` package for plain JavaScript projects or with frameworks like **Vue**, **Angular**, or **Solid.js**. This package provides the core SDK functionality without tying it to a specific UI library.

To install the package, run one of the following commands:

<CodeGroup title="Install the @suki-sdk/js Package">
  ```shell pnpm theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
  # [!code --:1] Removed in v3.0.0
  # pnpm add @suki-sdk/js
  # [!code ++:1] New in v3.0.0
  pnpm add @suki-sdk/js @suki-sdk/core
  ```

  ```shell npm theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
  # [!code --:1] Removed in v3.0.0
  # npm install @suki-sdk/js
  # [!code ++:1] New in v3.0.0
  npm install @suki-sdk/js @suki-sdk/core
  ```

  ```shell yarn theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
  # [!code --:1] Removed in v3.0.0
  # yarn add @suki-sdk/js
  # [!code ++:1] New in v3.0.0
  yarn add @suki-sdk/js @suki-sdk/core
  ```
</CodeGroup>

### For React

For React applications, you should use the `@suki-sdk/react` package. It includes React-specific hooks and components that make it easy to integrate Suki's functionality into your application.

To install the package, run one of the following commands:

<CodeGroup title="Install the @suki-sdk/react Package">
  ```shell pnpm theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
  # [!code --:1] Removed in v3.0.0
  # pnpm add @suki-sdk/react
  # [!code ++:1] New in v3.0.0
  pnpm add @suki-sdk/react @suki-sdk/core
  ```

  ```shell npm theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
  # [!code --:1] Removed in v3.0.0
  # npm install @suki-sdk/react
  # [!code ++:1] New in v3.0.0
  npm install @suki-sdk/react @suki-sdk/core
  ```

  ```shell yarn theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
  # [!code --:1] Removed in v3.0.0
  # yarn add @suki-sdk/react
  # [!code ++:1] New in v3.0.0
  yarn add @suki-sdk/react @suki-sdk/core
  ```
</CodeGroup>

<Note>
  **Web SDK v3:** You need `@suki-sdk/core` for `SukiAuthManager`. See [Migrating to Web SDK v3](/web-sdk/product-updates/migration-to-v3) if you are upgrading from v2.
</Note>

## Next steps

<Icon icon="file-lines" iconType="solid" /> Read the [Quickstart guide](/web-sdk/quickstart) to get started with the Suki SDK.