> ## Documentation Index
> Fetch the complete documentation index at: https://replyke-feat-push-rich-payload-fields.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Real-time 1:1 and group messaging with reactions, threading, and typing indicators

Sublay Chat lets you embed full-featured messaging directly into your application. It supports direct (1:1) conversations, group conversations, and per-space chat channels. All conversations are real-time, backed by Socket.io, with read receipts, typing indicators, reaction support, and threaded replies.

<Note>
  **Requires the `chat` bundle.** Chat is only available when the `chat` bundle is installed on your project. See [Bundles](/bundles) to add it.
</Note>

## In This Section

<CardGroup cols={2}>
  <Card title="Setup" href="/sdk/chat/setup">
    Add `ChatProvider` to your component tree to initialize the socket connection
  </Card>

  <Card title="Conversations" href="/sdk/chat/conversations">
    Create direct and group conversations, manage members, and render a live conversation list that reorders, inserts, and removes in real time
  </Card>

  <Card title="Messages" href="/sdk/chat/messages">
    Send, edit, delete, and react to messages with optimistic UI updates
  </Card>

  <Card title="Real-time" href="/sdk/chat/real-time">
    Socket events, typing indicators, unread counts, and read receipts
  </Card>

  <Card title="Threads" href="/sdk/chat/threads">
    Threaded replies to messages for focused side-conversations
  </Card>
</CardGroup>

## Architecture

Chat is built around a two-level provider hierarchy:

```
ChatProvider          — one per app; owns the socket connection
  └── Your UI         — conversation list, conversation views, etc.
```

`ChatProvider` establishes the Socket.io connection and maintains global state (unread counts, message store, and the live conversation list). Individual components then use the hooks directly — there is no second-level context required for basic usage. The conversation list stays current in real time and reconciles with the server on reconnect, so consumers never have to poll or refetch it manually.

For space chat, use `useFetchSpaceConversation` to retrieve the conversation associated with a space, then interact with it using the same hooks used for any other conversation.

## Conversation Types

| Type     | Description                                |
| -------- | ------------------------------------------ |
| `direct` | 1:1 conversation between two users         |
| `group`  | Multi-user conversation created explicitly |
| `space`  | Conversation automatically tied to a Space |

## Next Steps

Start with [Chat Setup](/sdk/chat/setup) to add `ChatProvider` to your app.