Conversation
A React component in Beamline's AI & agents category.
The scrolling column of a conversation: follows new content while you are at the bottom, stops when you scroll up to read, and offers a way back; shared by the agent conversation and the people chat.
Use it for
- The message column of any chat: agent conversations (with message and response) and people chat (chat-thread builds on it).
Not for
- A feed of events (timeline).
- A plain scrolling region (scroll-area).
Anatomy
- Conversation (scroll element; role log, named by aria-label; aria-busy while an answer arrives)
- ConversationContent (reading column, --conversation-width, default 720px)
- ConversationScrollButton (Jump to latest)
- ConversationEmptyState (title, description, icon, starter action)
- useConversation() (isAtBottom, scrollToBottom)
States
- following the bottom
- reading history (jump button shown)
- busy (an answer is streaming)
- empty
Keyboard
- The log scrolls with the keyboard like any scroller; Jump to latest is a button with its own name.
Motion
New content follows with a smooth scroll (instant under reduced motion); the jump button arrives in --motion-in and leaves in --motion-out, rising 6px (no rise under reduced motion).
Props
| Prop | Type | Default | Description |
|---|---|---|---|
Conversation: busy | boolean | — | aria-busy while an answer streams, so assistive tech reads it once settled. |
Conversation: …StickToBottom props | initial, resize, aria-label … | — | initial/resize default to smooth (instant with reduced motion). |
ConversationScrollButton: label | string | — | Default "Jump to latest". |
ConversationEmptyState: title / description / icon / action | ReactNode | — | |
useConversation() | () => { isAtBottom, scrollToBottom } | — | Inside a Conversation: take the reader to the latest message (after they send). |
style / ref | CSSProperties / native Ref | — | |
classNames | ConversationClassNames; ConversationScrollButtonClassNames | — |
Built from
- button
- empty-state
Dependencies
use-stick-to-bottom, lucide-react, motion
Import
import { ConversationContent, Conversation, ConversationEmptyState, ConversationScrollButton } from "@/components/conversation/conversation";
Get it
Conversation is part of Beamline: 190 React components and screens your coding agent (Claude Code, Codex, Cursor or any MCP client) installs into your app through Beamline's MCP server, as a ready-built package or as plain React source you can change. $49 one payment (regular $200), no subscription, a year of updates, one licence for your whole team. Get Beamline · Connect your agent
More in AI & agents
- Approval card: The agent stops and asks before it acts: what it wants to do, exactly what that changes, any choices it needs, and Approve or Reject; both run your…
- Attachment: A file tile: preview or typed glyph with the type named, name, size, upload progress, error with retry, and a keyboard-reachable remove.
- Chat thread: People talking to people: messages grouped by person and day, reactions, delivery and read receipts that glide to the newest message read, who is typing…
- Citations: Inline numbered citations that preview their source on hover or focus, plus a numbered source list; streamed answers flow in at an even pace with the…
- Context cards: The knowledge an agent retrieved before it answered: one card per chunk with what it is about, the text it read with the search words marked, how…
- Flowchart: A workflow as steps on a dotted canvas: a trigger, conditions that branch into paths side by side, actions and waits, read top to bottom; during a run…
- Image generation: The frame an AI image is generated into: a field of brand-hued pixels breathes with the progress while the model works, then the image arrives —…
- Message: One turn in a conversation with an agent: the person's words in a quiet bubble, the agent's answer on the page with its orb mark, trace, tool calls and…
- Plan: An agent's plan: numbered steps with live status, progress, and Approve / Edit / Reject when it needs sign-off; approving shows progress, and a refusal…
- Prompt bar: The agent composer: a field that grows, @ to add a source, / for a command, a model picker, files and dictation, and one button that sends with progress…
- Reasoning: The agent's trace, fed by your stream: a shimmering label and the seconds so far while it works, then "Thought for N seconds"; steps that check off…
- Recommendation card: One suggestion from the agent that the person may take or leave: what it suggests, why, the expected effect and how sure it is (a meter and a word…
- Response: An assistant's answer as streamed markdown in the system's reading type: bursty tokens flow in at an even pace, each new word fades in through a short…
- Selection actions: Select a passage and hand it to the agent: a bar over the selection with quick actions, your own instruction and More; while the agent works it says so…
- Task rows: Background work an agent is doing, one row per task: status as a glyph and a word, what it produced, how long it has run or took, a progress bar while…
- Tool call: One tool call in an agent's run: status, what it did and a short result on one quiet row that opens to the exact input and output; stops for permission…