Skip to main content
social.plus UIKit provides a comprehensive set of chat components for building modern messaging experiences. These components are designed to work seamlessly across all platforms with consistent functionality and customizable styling.

Chat Search

Powerful search across channels and messages

Recent Chats

Chat list and channel management

Conversation Chat

One-on-one and group messaging interface

Live Chat

Real-time chat for live events and streaming

Key Features

  • Instant message delivery and receipt
  • Read and unread message state
  • Message synchronization across devices
  • Text messages with formatting
  • Image and video sharing
  • Message reactions and replies
  • Mentions in messages
  • Message editing and deletion
  • Message search and filtering
  • Archive and unarchive chats
  • Push notifications
  • Message reporting
  • User blocking and muting
  • Profanity filtering
  • Admin moderation controls

Platform Support

All chat components are available across platforms with platform-specific optimizations:

Mobile Native

iOS & Android
  • Native performance and animations
  • Platform-specific UI patterns
  • Keyboard handling and input optimization
  • Push notification integration

Web & Cross-Platform

React Web & React Native
  • Embeds as React components via AmityUiKitProvider
  • Responsive design for all screen sizes

Getting Started

Basic Implementation

1

Initialize Chat

Set up the chat client with your social.plus credentials
2

Choose Components

Select the chat components that fit your use case
3

Customize Appearance

Apply your brand colors and styling
4

Configure Features

Enable or disable specific chat features

Quick Start Example

Component Architecture

Chat System Overview

Data Flow

1

Authentication

User authenticates with social.plus credentials
2

Channel Connection

Connect to specific chat channels or rooms
3

Real-Time Sync

Establish WebSocket connection for live updates
4

Message Handling

Send, receive, and display messages in real-time

Customization Options

Chat pages follow the UIKit page / component / element ID system. Set a network-wide theme in the top-level theme, then override a specific chat surface by its ID under customizations in your uikit.config.json — the same pattern used across every UIKit page.
Light & dark themes. Chat components support both light and dark themes. Dark mode is currently verified for chat components; other UIKit features adopt the expanded color set in a later release — see Component styling.
uikit.config.json
Chat page IDs include chat_home_page, chat_page, group_chat_page, and live_chat. For the full theming and localization model, see Component styling and Localization.

Performance Considerations

Message Pagination

Efficiently load message history with pagination

Image Optimization

Automatic image compression and caching

Offline Support

Queue messages when offline, sync when online

Memory Management

Optimize memory usage for long conversations

Best Practices

  • Implement pagination for message history
  • Use virtual scrolling for large conversations
  • Cache recent messages locally
  • Preload critical attachments
  • Use WebSocket connections efficiently
  • Implement proper reconnection logic
  • Handle connection state changes gracefully
  • Optimize update frequency
  • Show loading states and progress indicators
  • Implement smooth animations and transitions
  • Handle errors gracefully with user feedback
  • Support keyboard shortcuts and accessibility

Security Features

All chat components include built-in security features to protect user communications and prevent abuse.

Secure Transport

Messages are encrypted in transit (TLS)

Content Moderation

AI-powered profanity and content filtering

User Controls

Block, mute, and report functionality

Admin Tools

Comprehensive moderation and management tools

Integration Examples

Simple Chat Integration

For basic one-on-one or group messaging:
  1. Recent Chats List - Show user’s active conversations
  2. Conversation Chat - Full messaging interface
  3. Basic customization - Apply brand colors and styling

Live Event Chat

For live streaming or event chat:
  1. Live Chat Room - Real-time community messaging
  2. Moderation tools - Admin controls for large audiences
  3. Custom reactions - Event-specific reactions and features

Customer Support Chat

For customer service integration:
  1. Conversation Chat - Agent-customer messaging
  2. Media sharing - Image and video support
  3. Admin features - Supervisor tools and analytics

Next Steps

Chat Search

Add powerful search capabilities to your chat

Recent Chats

Create a comprehensive chat list interface

Conversation Chat

Implement one-on-one and group messaging

Live Chat

Build real-time community chat features