An in-app help launcher with search, articles and a hand-off to a person, openable from your UI.
Import it and pass your content. The props that matter most are listed next.
import * as React from "react";
import { HelpWidget, type HelpArticle, type HelpWidgetHandle } from "@/components/ui/notchset/blocks/help-widget";
export function Help({ articles }: { articles: HelpArticle[] }) {
const help = React.useRef<HelpWidgetHandle>(null);
return (
<HelpWidget
handle={help}
greeting="Hi. What do you need?"
articles={articles}
agent={{ name: "Ava", initials: "AM", replies: "REPLIES IN ABOUT 5 MIN" }}
onAsk={async (text: string, context: string | null) => {
const res = await fetch("/api/support/messages", { method: "POST", body: JSON.stringify({ text, context }) });
return ((await res.json()) as { reply: string }).reply;
}}
/>
);
}articles–
{ id, title, category, minutes, forPage?, lead, steps }[]forPage marks the ones listed on HOME before searching.
agent / greeting / status–
{ name, initials, replies } / string / { label, ok }Who answers, the HOME greeting and the system status line.
onAsk–
(text, context) => Promise<string>Send a message; resolve with the reply.
position / handle–
'fixed' | 'absolute' / Ref<{ open, openArticle, openChat }>Pinned to the viewport or a positioned parent; open it from your UI.
HelpWidgetdata-slot="help-widget"
The launcher and the HOME / ARTICLE / CHAT panel.
components/ui/notchset/blocks/help-widget.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
pnpm dlx shadcn@latest add @beautiful-ui-pro/help-widgetNeeds your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
Give your coding assistant the Markdown guide instead of screenshots.
https://beautiful-ui.dev/api/mcp (setup)v1.0.0 · 2026-10-04
First release
Pro is in early access.