Design System

Chat UI - Messaging

Overview
Review paths

Messaging

Message bubbles, thinking states, lightweight suggestions, and the runtime’s conversational affordances.

Message Bubbles

User and assistant message states with grouped follow-ups and feedback affordances.

Developer details

Start from these files when you need to trace the live implementation.

src/shared/ui/chat/ChatMessage.tsx

Hi! I just finished a big stone veneer project and want to showcase it.

Welcome to KnearMe! I'd love to help you build a portfolio piece for that stone veneer project. It sounds like a great showcase of your craftsmanship. Let's start by gathering some details.

We installed natural stone veneer on a 2-story fireplace surround. Used Pennsylvania fieldstone with a dry-stack pattern. Took about 3 weeks including prep and mortar curing time.

That sounds like an impressive project! A 2-story fireplace surround with Pennsylvania fieldstone is exactly the kind of work that wins new clients. I have a few questions to make your portfolio entry really shine.

Thinking & Tool Progress

Collapsed reasoning and tool-call activity should read as calm progress, not noisy chrome.

Developer details

Start from these files when you need to trace the live implementation.

src/shared/ui/chat/AgentActivityIndicator.tsx

Suggestions & Quick Actions

Shortcuts that reduce typing without replacing the chat as the primary interface.

Developer details

Start from these files when you need to trace the live implementation.

src/shared/ui/chat/ActionStrip.tsx · src/shared/ai-elements/suggestion.tsx

Runtime quick actions

AI Elements suggestions

Streaming Ornament

Shimmer stays subtle and should never overpower the surrounding shell.

Developer details

Start from these files when you need to trace the live implementation.

src/shared/ai-elements/shimmer.tsx

Thinking through the next best question…