Ampere AI Chatbot Widget

Self-contained React chatbot widget that renders Mimir LLM responses as Wave components. Designed to drop into any Wave-enabled React + Next.js host.

Quick start

import { AmpereWidget } from '@volue/ampere-widget';

<AmpereWidget
  apiUrl="/api/ampere/ask"
  ticketsUrl="/api/ampere/tickets"
  mode="wave"
  starters={['Why is wind low today?', 'Show my open tickets']}
  docsUrl="/docs"
/>;

See INTEGRATION.md for the full host-integration contract (dependencies, BFF routes, auth, ownership split).

Design

Internal design rationale lives in the customer-portal-frontend monorepo at docs/superpowers/specs/2026-04-22-ai-chatbot-widget-design.md. The integration contract documented in INTEGRATION.md is authoritative for hosts.

Next.js consumers in a monorepo workspace

If you consume this package via npm workspaces (i.e. the package resolves to source, not the published tarball), add it to transpilePackages in next.config.js:

const nextConfig = {
  transpilePackages: ['@volue/ampere-widget']
};

Consumers installing from npm receive built dist/ files and do not need this setting.