Companion skills (read first)
cometchat-ios-coreowns install, credentials,init → login → renderand the golden-path chat surface. This skill ADDS the per-component catalogue; it never restates core's setup. Fetch exact API viacometchat-ios-core/references/docs-map.md.
Use this skill when
Choosing a component, or customising one: "what shows the member list?", "put a badge on the conversation row", "swap the message bubble".
The catalogue (catalog-verified — nothing else exists)
| Component | For |
|---|---|
CometChatConversations | Recent-chats list · the usual entry point |
CometChatMessageHeader · CometChatMessageList · CometChatCompactMessageComposer | The chat screen — you compose these three yourself |
CometChatUsers · CometChatGroups · CometChatGroupMembers | Pickers and rosters |
CometChatSearch | Global search over conversations and messages |
CometChatThreadedMessageHeader | Thread parent header |
CometChatCallButtons · CometChatIncomingCall · CometChatOngoingCall · CometChatCallLogs | Calling → cometchat-ios-calls |
CometChatAvatar · CometChatBadge · CometChatStatusIndicator · CometChatDate · CometChatReceipt | Base building blocks |
CometChatMessageInformation · CometChatAIAssistanceChatHistory | Per-message detail · AI history |
CometChatScopeChange | Change a member's role. set(group:groupMember:), options: [(String, CometChat.MemberScope)] (property). PRESENT it as a sheet — its Cancel calls dismiss(), so pushing it strands the user. CometChatGroupMembers already presents it on row tap. |
There is NO composite component.
CometChatMessages,CometChat{Users,Groups,Conversations}WithMessages,CometChatAddMembers,CometChatMessageHeaderOptionare v4 or non-existent — never emit them. If a symbol is not incatalogs/ios-v5.json, it does not exist in v5, whatever a page says.
Three API shapes — get this right or nothing compiles
- Setters return
Selfand are chainable:set(user:),set(onItemClick:),set(subtitle:). - Properties are assigned:
list.avatarStyle = …,conversations.onSearchClick = { … },groups.onSelectedItemProceed = { … }. - Named setters —
setXxx(xxx:)with the label repeated:CometChatMessageInformationusessetSubtitle(subtitle:),setBubbleView(bubbleView:),setListItemView(listItemView:),setOnError(onError:). Writing them in shape-1 form (set(subtitle:)) does not compile on that component. Which is which is per component, and the kit is not consistent —CometChatConversationshasset(subtitleView:)/set(trailView:)whileCometChatUsersandCometChatGroupshaveset(subtitle:)/set(trailingView:), andCometChatGroupMembersuses the Conversations spelling. Never generalise a name across components — fetch the component's.mdtwin.
Where custom UI goes — IN the component's slot, never beside it
Every list component exposes: set(listItemView:) (whole row) · set(leadingView:) · set(titleView:) · subtitle · trailing · set(options:) (swipe/overflow actions). Use these instead of building your own row above the list.
Empty/error/loading are assignable views inherited from CometChatListBase: emptyStateView, errorStateView, loadingView, plus emptyStateTitleText / emptyStateSubTitleText to retitle the built-in one. CometChatSearch is the exception — it does NOT inherit CometChatListBase, so it has none of that chrome; it uses set(emptyView:) / set(errorView:) / set(loadingView:) instead.
Gotchas
set(controller:)on any component that presents something (header, list, composer) or its built-in affordances render and do nothing.CometChatAvatar— usesetAvatar(avatarUrl:with:).set(image:)andinit(image:)compile but render NOTHING. There is noset(user:). Measured on 5.1.19: an avatar given aUIImagethrough eitherset(image:)orinit(image:)draws an empty circle — the image never appears, with no warning and no error, because the kit paints its own content over it.setAvatar(avatarUrl:with:)is the working path, and itswith:name renders initials when no URL loads. There is also no no-arg init:CometChatAvatar()does not compile — construct withCometChatAvatar(image: nil)orCometChatAvatar(frame:)and then callsetAvatar.- Search slots are per result TYPE:
set(listItemViewForMessage:)plus…ForImage/Video/Audio/Document/Link/Conversation. There are no*ForMessagegranular (title/subtitle/leading/trailing) slots — those exist for conversations only, as properties.
Verify it works
The component renders at full size, its custom slot appears in the right place (inside the row, not above the list), and every rendered control does something when tapped.

