> ## Documentation Index
> Fetch the complete documentation index at: https://learn.social.plus/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat Module

> Choose the SDK surfaces for channels, members, messages, moderation, and chat engagement state.

The Chat SDK is the client surface for building channel-based messaging across TypeScript, iOS, Android, and Flutter. Use it to create and query channels, manage membership, send and read messages, apply moderation actions, and render engagement state such as previews, unread counts, read receipts, and delivery status.

<Tip>
  Looking for a product walkthrough? Use [Channels & Conversations](/use-cases/chat/channels-and-conversations) and [Sending Messages](/use-cases/chat/sending-messages). Use this section when you need the exact SDK objects and methods.
</Tip>

## SDK Area Map

| Area                    | Use it for                                                                                     | Start here                                                                                       |
| ----------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Conversation management | Create, query, update, archive, and organize chat channels.                                    | [Conversation Management](/social-plus-sdk/chat/conversation-management/overview)                |
| Member management       | Join or leave channels, query channel members, and read membership state.                      | [Member Management](/social-plus-sdk/chat/conversation-management/members/overview)              |
| Channel governance      | Add or remove members, roles, bans, and mutes.                                                 | [Channel Governance](/social-plus-sdk/chat/conversation-management/channels/governance/overview) |
| Messaging features      | Create, query, edit, delete, reply to, and flag messages.                                      | [Messaging Features](/social-plus-sdk/chat/messaging-features/overview)                          |
| Engagement features     | Read message previews, unread counts, read status, delivery status, and receipt sync state.    | [Unread Status Overview](/social-plus-sdk/chat/engagement-features/unread-status/overview)       |
| Content moderation      | Connect user reports, message deletion, and channel governance into a product moderation flow. | [Content Moderation](/social-plus-sdk/chat/moderation-safety/content-moderation/overview)        |

## Platform Coverage

| Capability group                  | TypeScript                            | iOS                                 | Android                             | Flutter                                       |
| --------------------------------- | ------------------------------------- | ----------------------------------- | ----------------------------------- | --------------------------------------------- |
| Channel lifecycle                 | Supported                             | Supported                           | Supported                           | Supported                                     |
| Member operations                 | Supported                             | Supported                           | Supported                           | Supported                                     |
| Channel governance                | Supported                             | Supported                           | Supported                           | Supported                                     |
| Message creation and querying     | Supported                             | Supported                           | Supported                           | Supported                                     |
| Message reactions and mentions    | Supported through core content APIs   | Supported through core content APIs | Supported through core content APIs | Supported through core content APIs           |
| Message preview and unread counts | Supported with platform-specific gaps | Supported                           | Supported                           | Supported with platform-specific gaps         |
| Delivery receipt user queries     | Supported                             | Supported                           | Supported                           | Not exposed in the current public Flutter SDK |
| Explicit receipt sync start/stop  | Supported                             | Supported                           | Supported                           | Not exposed in the current public Flutter SDK |

<Info>
  Platform gaps are documented on the specific feature pages. Do not copy a code snippet from another platform when a public SDK surface is not exposed for your target platform.
</Info>

## Implementation Shape

<CardGroup cols={2}>
  <Card title="Resolve the channel" href="/social-plus-sdk/chat/conversation-management/channels/create-channel" icon="comments">
    Create or query the channel that owns the conversation, then resolve the target `subChannelId` for message APIs.
  </Card>

  <Card title="Check membership" href="/social-plus-sdk/chat/conversation-management/members/join-leave-channel" icon="users">
    Use member state to decide whether the current user can read, join, send, or moderate.
  </Card>

  <Card title="Render messages" href="/social-plus-sdk/chat/messaging-features/messages/query-and-filter-messages" icon="list-filter">
    Query messages by subchannel, apply message-type filters, and handle edits or soft deletes from the message model.
  </Card>

  <Card title="Add engagement state" href="/social-plus-sdk/chat/engagement-features/message-preview" icon="eye">
    Read previews, unread counters, receipt counts, and receipt sync state from the SDK where supported.
  </Card>
</CardGroup>

## Product Boundaries

| Concern       | SDK owns                                                              | Your app owns                                                                          |
| ------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Identity      | Authenticated SDK user context and channel membership state.          | Login, user provisioning, and user-facing account policy.                              |
| Rendering     | Message, channel, member, receipt, and preview models.                | UI layout, empty states, moderation copy, and accessibility behavior.                  |
| Moderation    | Message flagging, message deletion, and channel governance APIs.      | Review queues, escalation policy, audit notes, appeal flows, and compliance workflows. |
| Notifications | Data fields such as unread count, mention state, and preview content. | Push-notification templates, routing, deep links, and notification preferences.        |

## Related Topics

<CardGroup cols={3}>
  <Card title="Create Channels" href="/social-plus-sdk/chat/conversation-management/channels/create-channel" icon="plus">
    Start a community, live, or conversation channel.
  </Card>

  <Card title="Send Messages" href="/social-plus-sdk/chat/messaging-features/message-creation/send-a-message" icon="paper-plane">
    Send text, media, custom, and reply messages.
  </Card>

  <Card title="Message Flagging" href="/social-plus-sdk/chat/messaging-features/message-flagging" icon="flag">
    Let users report and unreport chat messages.
  </Card>
</CardGroup>