Message

A conversation turn with optional sender, avatar, attachments, and actions.

  1. You

    Deploying to prod real quick.

  2. Oliver

    It’s 4:55 PM. On a Friday.

  3. You

    It’s a one-line change.

    Delivered
  4. Oliver

    It’s always a one-line change 😭.

    Alright, let me take a look.

    👍

Oliver is typing…

Usage

With a Basecoat style bundle loaded, put each message in its own list item. The final child is a content wrapper. Place an optional Avatar before it and a Bubble or ordinary text inside it. Set data-align="end" on outgoing messages.

<ol role="list" aria-label="Conversation">
  <li class="message">
    <div>
      <header>Olivia</header>
      <div class="bubble" data-variant="muted">
        <p>I already checked the logs.</p>
      </div>
    </div>
  </li>
</ol>

Include the sender as text, visually hidden if necessary. Use a footer for timestamps, delivery status, or actions. Message supplies layout only. Your application owns delivery and retry behavior.

Examples

Avatar

Use an empty image alternative when the message already identifies its sender.

  1. Oliver

    The build failed during dependency installation.

  2. You

    Can you share the exact error?

  3. Oliver

    Here’s the error from the logs.

    The libraries are not installed correctly. Try running the build again.

Group

Use message-group to stack consecutive messages from one sender. An invisible avatar reserves the same space on earlier rows.

  1. Oliver

    I checked the registry addresses.

  2. Oliver

    The component and example JSON now live under the UI registry.

  1. Olivia

    I already checked the logs.

  2. You

    Send the report to the team. Ping @shadcn if you need help.

    Read yesterday

Actions

  1. Oliver

    The install failure is coming from the workspace package.

  2. You

    Okay drop me a link. Taking a look…

    Failed to send

Attachment

Place the file next to its bubble inside the same message.

  1. You
    Workspace

    Here’s the image for the cover page.

  2. Oliver

    Here’s the sales report.

    sales-report.txt

    Text document

  3. You

    Thanks. Looks good.