Orbeez kit
Conversation

Message

<Message />
One turn in the conversation. The user's message is a dark bubble on the right; an agent's is white, or tinted in its colour.
Can you find why the cart total is off?
It skips the last item. The loop stops one short.
I wrote a test that fails on two items.

Install

npx shadcn@latest add https://orbeez-kit.vercel.app/r/message.json

Usage

tsx
<Message from="user">
  <MessageBody>
    <MessageContent from="user">Can you find why the cart total is off?</MessageContent>
  </MessageBody>
</Message>

<Message>
  <MessageAvatar hue="ink" mood={thinking ? 'thinking' : undefined} />
  <MessageBody>
    <MessageContent variant="plain" markdown>{answer}</MessageContent>
    <MessageActions>
      <CopyButton text={answer} />
      <FeedbackBeads size={18} />
    </MessageActions>
  </MessageBody>
</Message>

Good to know

  • Moods. MessageAvatar takes a mood: thinking while it reasons, working while it acts.
  • variant="plain" drops the bubble, which reads better for long answers.
  • MessageActions show on hover or focus, and always on touch screens.

System message

<SystemMessage />

A note from the app rather than from anyone in the conversation.

Agents can read and write files in this project.
You have 3 agent runs left today.
npx shadcn@latest add https://orbeez-kit.vercel.app/r/system-message.json
tsx
<SystemMessage variant="warning" action={<Button size="sm">Upgrade</Button>}>
  You have 3 agent runs left today.
</SystemMessage>

Attachments

<MessageAttachments />

The files that came with a message, as the same chips they were in the prompt, on the side of whoever sent them.

checkout.pngpng · 284 KB
cart-errors.txttxt · 12 KB
The total is wrong on this screen. Logs attached.
tsx
<Message from="user">
  <MessageBody>
    <MessageAttachments>
      {files.map((f) => <Attachment key={f.id} name={f.name} bytes={f.bytes} preview={f.thumbnail} />)}
    </MessageAttachments>
    <MessageContent from="user">{text}</MessageContent>
  </MessageBody>
</Message>
  • Give each Attachment only its name, size and preview. In a message it is sent, so it has no status and nothing to remove.
  • preview puts a picture, like a thumbnail URL, in the icon's box, at the same size.

Behaviour

  • Chips are the same fixed size as in the prompt, so a message with files never reflows as they load.
  • They sit on the sender's side and wrap onto more lines rather than scroll.
  • Chips there when the message first shows do not pop in, so history loads still.

Marker

<Marker />

A mark between turns that nobody said: a rule with words for a break like a new day, or a quiet line for something that happened, like an agent joining.

Today
Reviewer joined the conversation
Context compacted to save room
npx shadcn@latest add https://orbeez-kit.vercel.app/r/marker.json
tsx
<Marker>Today</Marker>
<Marker variant="note" hue={338} accessory="goggles">Reviewer joined</Marker>
<Marker hue="ink" mood="sleepy">Context compacted</Marker>

Behaviour

  • One line, always the same height. Long words truncate rather than wrap.
  • Its bead takes a fixed box beside the words and never changes the line's height.

Feedback bar

<FeedbackBar />

Asks whether an answer helped, with two bead buttons, and confirms the choice.

Was this helpful?Thanks, noted.
npx shadcn@latest add https://orbeez-kit.vercel.app/r/feedback-bar.json
tsx
<FeedbackBar onFeedback={(helpful) => log(helpful)} onClose={dismiss} />

// just the beads, for message actions
<FeedbackBeads size={18} onFeedback={rate} />
  • Moods. The picked bead briefly plays love or sad. Both beads are muted until hovered or picked; the one not picked stays muted, so the answer can still be changed.

Behaviour

  • The beads pop in left to right when the bar appears, and never move once they are in.
  • With reduced motion they only fade, and nothing waits.

Branch picker

<BranchPicker />

Steps between the answers a message was given, when it was asked again or edited.

2 / 3
npx shadcn@latest add https://orbeez-kit.vercel.app/r/branch-picker.json
tsx
<BranchPicker index={i} count={answers.length} onChange={setI} />
<CopyButton text={answer} />