About chat-widget

What it is for

It gives site visitors a floating chat assistant configurable with your instructions, theme, quick links, and contextual info — embedded with a single script tag.

Architecture

• embed.js — runs on the host page; injects the bubble and iframe.
• widget.html — tabbed chat UI inside the iframe.
• chatbot.js — Netlify Function that proxies OpenAI securely.

See the full architecture doc: docs/architecture.md

Documentation

• Architecture — system overview and message protocol
• Embedding guide — embed patterns and host JS API
• Config reference — all config fields
• Development — local setup and deploy
• Decisions — architecture decision records

Pages

• Home — minimal setup and live demo
• Advanced setup — interactive config generator
• Widget UI — runtime widget interface
• Examples — resort, agency, marketplace demos

Routes

• Canonical: /embed.js, /widget.html, /
• Legacy: /v1/* and /v2/* forward to canonical paths

Host API

After embed loads, control the widget from your page:

window.ChatWidget.open();
window.ChatWidget.close();
window.ChatWidget.toggle();
window.ChatWidget.isOpen();