customware-support-widget

SKILL.md

Customware Support Widget

Use this skill when the Customware React Router client-only SPA template needs a Customware support chat entry point.

The widget is a third-party browser custom element. In this template, load the widget script in root.tsx or the equivalent React Router root file/component where the HTML document structure is defined, and render <customware-chat> only in the route or layout where support should appear. The widget owns its Shadow DOM UI, chat runtime, service calls, tool badges, speech input, and page-operation behavior.

For all React code examples, script loading patterns, JSX typing, bubble/full mode examples, metadata, and style options, read references/component-usage.md.

What It Offers

A support chat UI as <customware-chat>.

chat-bubble mode for a floating launcher/dialog.

full mode for a sidebar, rail, drawer, or split-pane chat region.

Optional visitor metadata through the meta DOM property.

Optional sizing/customization through styleOptions or style-options.

Tool-backed support behavior: read domain/context, list tasks, create tasks, and operate the visible page.

Page operation for user requests like filling forms, selecting options, clicking buttons, replacing values, or submitting visible UI.

When To Use