@assistrio/chat-widget

Embeddable chat UI (CDN assistrio-chat.js / assistrio-chat.css) and npm ESM entry for React apps.

Install

npm install @assistrio/chat-widget

Peers: react and react-dom (^18 or ^19).

React apps (customer / admin dashboards)

Prefer split entries so Vite can lazy-load the heavy widget separately from text helpers:

// Heavy UI (lazy-load in preview hosts)
import { AdminLiveChatAdapter, EmbedWidgetRoot } from "@assistrio/chat-widget/runtime";

// Lightweight copy/helpers (conversation transcripts, playground)
import { prepareChatMessagePlainText, resolveWelcomeMessage } from "@assistrio/chat-widget/text";

import "@assistrio/chat-widget/assistrio-chat.css";

Full barrel (backward compatible):

import { AdminLiveChatAdapter, prepareChatMessagePlainText } from "@assistrio/chat-widget";

Server-safe quick-link icons only (no full widget bundle):

import { getQuickLinkIcon, QUICK_LINK_ICON_IDS } from "@assistrio/chat-widget/quick-link-icons";

CDN embed (landing / customer sites)

<link rel="stylesheet" href="https://widget.assistrio.com/assistrio-chat.css" />
<script src="https://widget.assistrio.com/assistrio-chat.js" defer></script>

Or from npm paths (self-hosted):

• @assistrio/chat-widget/assistrio-chat.js
• @assistrio/chat-widget/assistrio-chat.css

Monorepo local dev

From this package:

npm run build
npm pack

Install the tarball into a consuming app (keeps ^0.1.x in package.json without a file:../ path):

npm install ./vendor/assistrio-chat-widget-0.1.6.tgz

Environment

The package does not use a .env file. The host page passes runtime config (apiBaseUrl, botId, keys, etc.).

When deployed to Vercel at widget.assistrio.com, the project also serves GET /api/widget/geo — a signed Vercel geo bootstrap used by the embed bundle (see WIDGET_GEO_TOKEN_SECRET in .env.example). Chat traffic still goes directly to chat.assistrio.com.

For full-stack local setup, see docs/ARCHITECTURE_AND_LOCAL_DEV.md.

Building

npm run build

Runs clean:dist, CDN bundle, CSS, ESM lib (index.mjs, runtime.mjs, text.mjs), and declarations.