MessageScroller
1.0.0A chat transcript scroller that anchors turns, follows streamed replies, and preserves the reader's place.
Component data
- ID
- message-scroller
- Category
- atoms
- Version
- 1.0.0
- Added
- 2026-09-17
- Type
- component
- Keyboard nav
- Yes
- Reduced motion
- Yes
message-scrollerchatscrolltranscriptatom
Dependencies
- @shadcn/react
- lucide-react
- clsx
- tailwind-merge
Registry
- button
- message
- marker
Examples
Default
<div className={frameClass}>
<MessageScrollerProvider autoScroll defaultScrollPosition="end">
<MessageScroller>
<MessageScrollerViewport>
<MessageScrollerContent className="px-4 py-6">
<MessageScrollerItem messageId="user-1" scrollAnchor>
<Message align="end">
<MessageAvatar>
<Avatar>
<AvatarFallback>
{messageScrollerMocks.default.meInitials}
</AvatarFallback>
</Avatar>
</MessageAvatar>
<MessageContent>
<Bubble>
<BubbleContent>
{messageScrollerMocks.default.morning}
</BubbleContent>
</Bubble>
</MessageContent>
</Message>
</MessageScrollerItem>
<MessageScrollerItem messageId="assistant-1">
<Message>
<MessageAvatar>
<Avatar>
<AvatarFallback>
{messageScrollerMocks.default.otherInitials}
</AvatarFallback>
</Avatar>
</MessageAvatar>
<MessageContent>
<Bubble variant="muted">
<BubbleContent>
{messageScrollerMocks.default.workingOn}
</BubbleContent>
</Bubble>
</MessageContent>
</Message>
</MessageScrollerItem>
<MessageScrollerItem messageId="user-2" scrollAnchor>
<Message align="end">
<MessageAvatar>
<Avatar>
<AvatarFallback>
{messageScrollerMocks.default.meInitials}
</AvatarFallback>
</Avatar>
</MessageAvatar>
<MessageContent>
<Bubble>
<BubbleContent>
{messageScrollerMocks.default.scrollJump}
</BubbleContent>
</Bubble>
</MessageContent>
</Message>
</MessageScrollerItem>
<MessageScrollerItem messageId="assistant-2">
<Message>
<MessageAvatar>
<Avatar>
<AvatarFallback>
{messageScrollerMocks.default.otherInitials}
</AvatarFallback>
</Avatar>
</MessageAvatar>
<MessageContent>
<Bubble variant="muted">
<BubbleContent>
{messageScrollerMocks.default.followLive}
</BubbleContent>
</Bubble>
</MessageContent>
</Message>
</MessageScrollerItem>
<MessageScrollerItem messageId="user-3" scrollAnchor>
<Message align="end">
<MessageAvatar>
<Avatar>
<AvatarFallback>
{messageScrollerMocks.default.meInitials}
</AvatarFallback>
</Avatar>
</MessageAvatar>
<MessageContent>
<Bubble>
<BubbleContent>
{messageScrollerMocks.default.newTurn}
</BubbleContent>
</Bubble>
</MessageContent>
</Message>
</MessageScrollerItem>
</MessageScrollerContent>
</MessageScrollerViewport>
<MessageScrollerButton />
</MessageScroller>
</MessageScrollerProvider>
</div>GroupChat
<div className={frameClass}>
<MessageScrollerProvider
autoScroll
defaultScrollPosition="last-anchor"
scrollPreviousItemPeek={64}
>
<MessageScroller>
<MessageScrollerViewport>
<MessageScrollerContent className="px-4 py-6">
<MessageScrollerItem messageId="marcus-joined" scrollAnchor>
<Marker variant="separator">
<MarkerContent>
{messageScrollerMocks.group.joined}
</MarkerContent>
</Marker>
</MessageScrollerItem>
<MessageScrollerItem messageId="user-mention">
<Message>
<MessageAvatar>
<Avatar>
<AvatarFallback>
{messageScrollerMocks.group.initials}
</AvatarFallback>
</Avatar>
</MessageAvatar>
<MessageContent>
<Bubble variant="muted">
<BubbleContent>
{messageScrollerMocks.group.mention}
</BubbleContent>
</Bubble>
</MessageContent>
</Message>
</MessageScrollerItem>
<MessageScrollerItem messageId="user-ping">
<Message>
<MessageAvatar>
<Avatar>
<AvatarFallback>
{messageScrollerMocks.group.initials}
</AvatarFallback>
</Avatar>
</MessageAvatar>
<MessageContent>
<Bubble variant="muted">
<BubbleContent>
{messageScrollerMocks.group.ping}
</BubbleContent>
</Bubble>
</MessageContent>
</Message>
</MessageScrollerItem>
<MessageScrollerItem messageId="assistant-reply">
<Message>
<MessageAvatar>
<Avatar>
<AvatarFallback>
{messageScrollerMocks.group.assistant}
</AvatarFallback>
</Avatar>
</MessageAvatar>
<MessageContent>
<Bubble variant="muted">
<BubbleContent>
{messageScrollerMocks.default.followLive}
</BubbleContent>
</Bubble>
</MessageContent>
</Message>
</MessageScrollerItem>
</MessageScrollerContent>
</MessageScrollerViewport>
<MessageScrollerButton />
</MessageScroller>
</MessageScrollerProvider>
</div>
