Skip to main content
For React apps where you want full control over layout, theming, and lifecycle, import the chat directly from @waniwani/sdk/chat.
Platform feature. Requires a Waniwani project token (wwp_...). Get one at app.waniwani.ai or read more about the Platform.

Install

Add the stylesheet to your app once (e.g. in _app.tsx or your root layout):

ChatEmbed

Borderless chat that fills its parent container — drop it inside any layout that already provides its own chrome. api is required; there is no default.
ChatEmbed is backend-agnostic: pass any api endpoint that implements the Vercel AI SDK chat protocol and the component handles the rest.

Theming

Pick a preset (light, dark, or auto) and optionally layer per-property overrides on top:
auto follows the host’s prefers-color-scheme. For finer-grained customisation, set --ww-* CSS variables on the chat’s container — see Theming the chat widget for the full variable list.