Skip to main content
Embed live WisdomAI dashboards directly inside your own React application. The SDK renders Wisdom’s interactive analytics: charts, metrics, tables and filters as native React components in your DOM (no iframe). They flow with your layout and inherit your theming, placed inside your own pages like any other component.

​
What you can do today

  • Embed a full dashboard: Drop an entire Wisdom dashboard into a page with a single component.
  • Embed a single widget: Render one chart, metric, or table on its own and place it anywhere in your UI.
  • Chat: Embed a conversation surface where viewers ask questions in natural language and get streamed answers, charts, tables, and narratives, with or without a dashboard.
  • DashChat: Attach that chat to a dashboard as a side panel scoped to the dashboard’s own domains, with follow-up questions seeded from any widget.
  • Brand-native widget cards (advanced): Render a widget’s visualization without Wisdom’s built-in card chrome and wrap it in your own container (see Components).
  • Interactive analytics: Charts, time series, stacked breakdowns, data tables, and KPI metrics, all fully interactive (zoom, tooltips, export-to-data).
  • Filtering: Show Wisdom’s built-in filter bar, or drive filters from your own application state.
  • Theming: Match the embedded content to your product’s colors, typography, and chart palette.
  • Multi-tenant ready: Issue per-user tokens so each of your end users only sees the data they’re entitled to.

​
Packages

The SDK is published publicly on the npm registry under the @wisdomai scope:
Both packages are MIT-licensed and ESM-first.

​
How the docs are organized

Quickstart

Install, wire up auth, and render your first dashboard.

Components

Embed dashboards, single widgets, custom widget cards, and filters.

Authentication

The @wisdomai/node token exchange, WisdomProvider, and per-user (multi-tenant) tokens.

​
What’s coming

Dashboard consumption, Chat, and DashChat are available today (see Components). On the near-term roadmap:
  • List views: Dashboard and conversation lists, so an embed can offer browsing and chat history.
  • Dashboard authoring: Create and edit dashboards directly from the SDK.
  • Agents: Scheduled and triggered analysis in the embed.

​
FAQs

The current release is React. Web component and framework-agnostic support is on the roadmap.
WisdomProvider accepts a tokenProvider function that returns a JWT. Your backend controls token generation and expiry. No WisdomAI credentials are exposed in the browser.
Yes. JWT-based authentication carries the user’s identity, which WisdomAI uses to enforce row-level security. Each embedded user sees only their own data.
A tokenProvider that returns a fresh token on each call is the recommended pattern for long-lived sessions.
Yes. The iframe path remains available and unchanged. The SDK is an additive option for teams that need composability, theming, or programmatic filter control beyond what iframes support.
WisdomGlobalFilters renders the filters configured on the dashboard. Refs and callbacks give your application programmatic control over the filter state for tighter native integration.
Chat and DashChat ship in @wisdomai/react@0.0.12, currently published on the next npm tag: npm install @wisdomai/react@next.

​
Next steps

Quickstart

Set up the SDK and embed your first dashboard in minutes.

Components

Browse the React components available for embed a full dashboard, composable widgets, and filters.