# Chat Thread

Scrollable container for stacking ChatMessage components in a conversation thread



<ComponentPreview base="ink" name="chat-thread-demo" />

Installation [#installation]

<CodeTabs>
  <TabsList>
    <TabsTrigger value="cli">
      Command
    </TabsTrigger>

    <TabsTrigger value="manual">
      Manual
    </TabsTrigger>
  </TabsList>

  <TabsContent value="cli">
    ```bash
    npx shadcn@latest add @termcn/ink/chat-thread
    ```
  </TabsContent>

  <TabsContent value="manual">
    <Steps>
      <Step>
        Install the following dependencies:
      </Step>

      ```bash
      npm install ink
      ```

      <Step>
        Copy and paste the following code into your project.
      </Step>

      <ComponentSource src="registry/bases/ink/ui/types.ts" title="components/ui/types.ts" />

      <ComponentSource src="registry/bases/ink/themes/default.ts" title="lib/terminal-themes/default.ts" />

      <ComponentSource base="ink" name="chat-thread" title="components/ui/chat-thread.tsx" />

      <Step>
        Update the import paths to match your project setup.
      </Step>
    </Steps>
  </TabsContent>
</CodeTabs>

Usage [#usage]

```tsx
import { ChatThread } from "@/components/ui/chat-thread";
import { ChatMessage } from "@/components/ui/chat-message";
```

```tsx
<ChatThread maxHeight={20}>
  <ChatMessage sender="user">How do I center a div?</ChatMessage>
  <ChatMessage sender="assistant">
    Use flexbox: display flex, justify-content center, align-items center.
  </ChatMessage>
</ChatThread>
```

API Reference [#api-reference]

ChatThread [#chatthread]

| Prop         | Type        | Default |
| ------------ | ----------- | ------- |
| `maxHeight`  | `number`    | -       |
| `autoScroll` | `boolean`   | `true`  |
| `children`   | `ReactNode` | -       |

Notes [#notes]

Accessibility [#accessibility]

termcn exposes the following behavior through Ink's terminal accessibility APIs. This is not a browser ARIA or general WCAG-conformance claim.

* **Screen reader:** Ink labels and semantic state expose the component without relying on visual styling alone.