Skip to Content

Floating Chat Launcher Widget

Floating AI chat widget pill with an orb that opens a non-modal dialog: a greeting with suggested starter prompts, then the conversation and a message input. Comes with a scripted preview reply.

Installation

pnpm dlx shadcn@latest add @01orbital/chat-launcher-01

Anatomy

Floating Chat Launcher Widget is built from 2 parts.

  • ChatLauncher01: The chat launcher block: a closed ChatWidget floating over the page, with three suggested questions that get scripted, typed-out answers, one of them citing a piece. Replace send with useChatStream to answer from your own chat route.
  • ChatWidget: A chat launcher pinned to the bottom center of the window: a pill with an orb, a title and a status line. Clicking it opens a chat panel over it, with a greeting and suggested questions before the first message, then the conversation and a message field. The built-in orb breathes while the panel is open.

API reference

ChatLauncher01

The chat launcher block: a closed ChatWidget floating over the page, with three suggested questions that get scripted, typed-out answers, one of them citing a piece. Replace send with useChatStream to answer from your own chat route.

ChatWidget

A chat launcher pinned to the bottom center of the window: a pill with an orb, a title and a status line. Clicking it opens a chat panel over it, with a greeting and suggested questions before the first message, then the conversation and a message field. The built-in orb breathes while the panel is open.

The panel is a non-modal dialog, so the rest of the page stays usable while it is open. Pass your own turns and onSend to connect a chat.

Prop

Type

Make it yours

  • Its words are in COPY at the top of components/blocks/chat/chat-launcher-01/index.tsx: change them there, not in the markup.
  • SUGGESTIONS, ANSWERS, SAMPLE_REPLY, CITED and PALETTES, also at the top of the file, hold its lists and settings.
  • Its look comes from Orbital Palettes and Orbital V4; each page lists the props that change it.

Built from

npm: @base-ui/react, @phosphor-icons/react, cn. The CLI installs them for you.

Built from these parts. The CLI adds each one that is missing and won't replace a file you already have unless you choose to:

The shadcn parts here are their Base UI versions, and this piece uses Base UI's API. A Radix version you already have won't work with it.

Last updated on