Skip to main content

Overview

The React package (@suki-sdk/dictation-react) wraps the same DictationClient you use in JavaScript. You provide the client once via DictationProvider, then render Dictation where you need it. This guide follows React Integration in Suki Dictation SDK.md.

Prerequisites

Wrap the tree once

React
import { DictationProvider } from "@suki-sdk/dictation-react";

<DictationProvider client={client}>
  {/* your app */}
</DictationProvider>
Create client with new DictationClient({ authManager }) after you construct SukiAuthManager.

Render dictation conditionally

React
{activeField === "notes" && (
  <Dictation
    fieldId="notes"
    mode="in-field"
    initialText={value}
    onSubmit={handleSubmit}
  />
)}

Unmounting and hide()

When the Dictation component unmounts, the SDK automatically calls hide(). You do not need to call hide() yourself for normal React unmount flows.
Use state such as activeFieldId so only one field owns the dictation session at a time. That matches the spec guidance for controlling which input owns dictation.

Next steps

Last modified on June 30, 2026