git clone https://github.com/Tencent-RTC/TUIKit_iOS_SwiftUI.git

atomic-x/
├── Sources/              # UI 组件源码（必需集成）
│   ├── MessageList/      # 消息列表组件
│   ├── MessageInput/     # 消息输入组件
│   ├── ConversationList/ # 会话列表组件
│   ├── ContactList/      # 联系人列表组件
│   ├── BaseComponent/    # 基础组件
│   └── ...               # 其他UI组件
├── Resources/            # 资源文件（必需集成）
│   ├── assets/           # 图片资源
│   └── strings/          # 本地化字符串文件
chat/
├── uikit/                # Page 组件（参考实现）
│   ├── ChatPage.swift
│   ├── ContactsPage.swift
│   └── ConversationsPage.swift
└── demo/                 # 示例应用（可选参考）

import AtomicXCore

// 用户登录
LoginStore.shared.login(sdkAppID: sdkAppID, userID: userID, userSig: userSig, completion: { [weak self] result in
    guard let self = self else { return }
    switch result {
    case .success:
        // 登录成功，可跳转聊天或会话页
    case .failure(let error):    
        // 登录失败，可弹框报错
    }
})

import AtomicX
import AtomicXCore
import SwiftUI

public struct ConversationsPage: View {
    ...
    
    public var body: some View {
        VStack(spacing: 0) {
            headerView
            ConversationList(
                onConversationClick: { conversation in
                    // Customize onConversationClick event
                    onShowMessage?(NavigationInfo(conversation: conversation))
                }
            )
            .environmentObject(themeState)
        }
        .onReceive(contactListStore.state.subscribe(StatePublisherSelector(keyPath: \\ContactListState.friendList))) { friendList in
            if self.friendList != friendList {
                self.friendList = friendList
            }
        }
        .onAppear {
            contactListStore.fetchFriendList(completion: { _ in })
        }
        .overlay(
            // Click + to show this menu.
            ChatsMenuOverlay(
                showChatsMenu: $showChatsMenu,
                showStartConversation: $showStartConversation,
                showUserPicker: $showUserPicker
            )
        )
        ...
    }
    ...
}

private var headerView: some View {
    HStack {
        Text(LocalizedChatString("TabChats"))
            .font(.system(size: 34, weight: .semibold))
            .tracking(0.3)
            .foregroundColor(themeState.colors.textColorPrimary)
            .background(themeState.colors.listColorDefault)
            .padding(.leading, 16)
        Spacer()
        if AppBuilderConfig.shared.enableCreateConversation {
            Button(action: {
                showChatsMenu.toggle()
            }) {
                Image(systemName: "plus")
                    .font(.system(size: 20))
                    .foregroundColor(themeState.colors.buttonColorPrimaryDefault)
                    .frame(width: 28, height: 28)
                    .cornerRadius(14)
            }
            .padding(.trailing, 16)
        }
    }
    .padding(.top, 12)
    .padding(.bottom, 16)
}

import AtomicX
import AtomicXCore
import SwiftUI

public struct ChatPage: View {
    ...
    
    public var body: some View {
        return VStack(spacing: 0) {
            self.navigationBarView

            Divider()
                .background(self.themeState.colors.strokeColorPrimary)

            VStack(spacing: 0) {
                MessageList(
                    conversationID: self.conversation.id,
                    listStyle: self.listStyle,
                    locateMessage: self.locateMessage,
                    onUserClick: { userID in
                        onUserAvatarClick?(userID)
                    }
                )

                self.messageInputAreaView
            }
            .ignoresSafeArea(.keyboard)
        }
        .toast(toast)
    }
    
    // Header 
    private var navigationBarView: some View {
        HStack {
            Button(action: {
                onBack?()
            }) {
                Image(systemName: "chevron.left")
                    .font(.system(size: 18, weight: .semibold))
                    .foregroundColor(themeState.colors.textColorLink)
            }
            .padding(.leading, 16)

            Button(action: {
                onNavigationAvatarClick?()
            }) {
                HStack(spacing: 12) {
                    Avatar(
                        url: conversation.avatarURL,
                        name: conversation.title ?? conversation.conversationID,
                        size: .s
                    )

                    VStack(alignment: .leading, spacing: 2) {
                        Text(conversation.title ?? conversation.conversationID)
                            .font(.system(size: 17, weight: .semibold))
                            .foregroundColor(themeState.colors.textColorPrimary)
                            .lineLimit(1)

                        if conversation.type == .group {
                            Text("Group Chat")
                                .font(.system(size: 12))
                                .foregroundColor(themeState.colors.textColorSecondary)
                        }
                    }
                }
            }
            .buttonStyle(PlainButtonStyle())

            Spacer()
        }
        .frame(height: 44)
    }

    // MessageInput
    private var messageInputAreaView: some View {
        VStack(spacing: 0) {
            MessageInput(
                text: $messageText,
                conversationID: conversation.id,
                style: inputStyle,
                onHeightChange: { height in
                    self.inputAreaHeight = height
                }
            )
            .padding(.bottom, 8)
        }
    }
    
    ...
}

import AtomicX
import AtomicXCore
import SwiftUI

public struct ContactsPage: View {
    ...
     
    public var body: some View {
        VStack(spacing: 0) {
            headerView
            ContactList(
                contactStore: contactStore,
                onShowMessage: onShowMessage,
                onContactClick: onContactClick,
                onGroupClick: onGroupClick,
                onNewFriendsClick: onNewFriendsClick,
                onGroupApplicationsClick: onGroupApplicationsClick,
                onGroupListClick: onGroupListClick,
                onBlackListClick: onBlackListClick
            )
        }
        .overlay(
            Group {
                if showAddContactMenu {
                    VStack {
                        HStack {
                            Spacer()
                            AddContactPopView(
                                onDismiss: {
                                    showAddContactMenu = false
                                },
                                onShowAddFriend: {
                                    showAddFriend = true
                                },
                                onShowJoinGroup: {
                                    showJoinGroup = true
                                }
                            )
                            .padding(.trailing, 16)
                            .padding(.top, 50)
                        }
                        Spacer()
                    }
                    .background(
                        Color.clear
                            .contentShape(Rectangle())
                            .onTapGesture {
                                showAddContactMenu = false
                            }
                    )
                    .animation(.easeInOut(duration: 0.2), value: showAddContactMenu)
                }
            }
        )
        .sheet(isPresented: $showAddFriend) {
            AddFriendView(contactStore: contactStore)
        }
        .sheet(isPresented: $showJoinGroup) {
            JoinGroupView(contactStore: contactStore)
        }
    }

    private var headerView: some View {
        HStack {
            Text(LocalizedChatString("TabContacts"))
                .font(.system(size: 34, weight: .semibold))
                .tracking(0.3)
                .foregroundColor(themeState.colors.textColorPrimary)
                .padding(.leading, 16)
            Spacer()
            Button(action: {
                showAddContactMenu = true
            }) {
                Image(systemName: "plus")
                    .font(.system(size: 20))
                    .foregroundColor(themeState.colors.buttonColorPrimaryDefault)
                    .frame(width: 28, height: 28)
                    .cornerRadius(14)
            }
            .padding(.trailing, 16)
        }
        .padding(.top, 12)
        .padding(.bottom, 16)
    }
    
    ...
}

// 点击会话列表 cell 跳转
ConversationsPage(
    onConversationClick: { navigationInfo in
        showChatPage(conversation: navigationInfo.conversation, locateMessage: navigationInfo.locateMessage)
    }
)

// 点击联系人页面跳转
ContactsPage(
    onContactClick: { user in
        showContactDetail(user)
    },
    onGroupClick: { group in
        let conversation = createConversationFromGroup(group)
        showChatPage(conversation: conversation)
    }
)

// ChatNavPage 是对 ChatPage 外层封装了导航栏的页面
ChatNavPage(
    conversation: conversation,
    locateMessage: currentLocateMessage,
    onBack: {
        dismissChatPage()
    },
    onContactDelete: {
        dismissChatPage()
    },
    onGroupDelete: {
        dismissChatPage()
    },
    onNavigateToChat: { newConversation in
        // First dismiss current chat page, then navigate to the new chat
        dismissChatPage()
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
            showChatPage(conversation: newConversation)
        }
    }
)