Document iOS multiple attachments (SDK + UI Kit)

[adityakotasthane07]

SDK:

• send-message: rewrite the multiple-attachments section around the upload-first flow (uploadFiles, MediaCallbackListener, cancelFile), document upload limits (file.count.max / file.size.max), the error codes table, the files-must-stay-nil warning, and keep the direct send form as a legacy sub-section

UI Kit:

• message-composer / compact-message-composer: new Multiple Attachments section (multi-select picking, attachment tray, upload-before-send, per-type message split, clipboard paste, voice-note exception, edit-mode behavior), server-driven limits and validation table, CometChatErrorStateStyle theming, enableMultipleAttachments prop
• message-list: per-type bubbles, batch grouping behavior and the set(enableMultipleAttachments:) toggle
• message-bubble-styling: new Media Grid Bubble, Audio Files Bubble and Files Bubble sections with GalleryBubbleStyle properties
• core-features: Media Sharing rewritten to lead with the multi-attachment flow

Description

Related Issue(s)

Type of Change

• Documentation correction/update
• New documentation
• Improvement to existing documentation
• Typo fix
• Other (please specify)

Checklist

• I have read the CONTRIBUTING document
• My branch name follows the naming convention
• My changes follow the documentation style guide
• I have checked for spelling and grammar errors
• All links in my changes are valid and working
• My changes are accurately described in this pull request

Additional Information

Screenshots (if applicable)

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
cometchat	🟢 Ready	View Preview	Jul 13, 2026, 3:12 PM

[jitvarpatil]

Docs review — ✅ Approve

iOS multi-attachment docs — SDK upload-first flow + UIKit composer/bubble updates (6 files, +309/-27). No file deletions/nav change → no redirect risk. I verified the entire SDK API against the exact matching feature branch (ENG-36750/iossdk-multi-attachment-presigned-upload-support) — every symbol, signature, and default matches. Structurally clean.

✅ SDK API — verified against ENG-36750

• CometChat.uploadFiles(files:listener:) — real public API (CometChat+FileUpload.swift).
• MediaCallbackListener — upload listener with exactly the 4 documented methods: onSuccess(fileId:attachment:), onProgress(fileId:bytesUploaded:totalBytes:), onError(fileId:error:), onFailure(fileId:error:).
• MediaMessage.attachments: [Attachment]? — settable property (MediaMessage.swift:66), matching mediaMessage.attachments = uploadedAttachments.
• getMaxFileCount() → file.count.max, "Defaults to 10" (matches exactly); getMaxFileSize() → file.size.max (100 MB).
• sendMediaMessage, Attachment confirmed. The "leave files nil; an empty files array fails with invalid-message error" note is consistent with the file-count logic.

✅ Structure & UIKit

• 0 nav breaks, 0 orphans, 0 broken links in the changed files; all internal links resolve. (The 2 sdk/ios links the analyzer flagged — default-calling/login-listeners — are pre-existing in unchanged files, not send-message.mdx.)
• UIKit docs use the existing CometChatMessageComposer + attachmentOptions. No placeholders/TODOs.

Note

The SDK feature is on ENG-36750 (freshest branch) — i.e. this documents an in-progress feature. Please confirm the SDK version with uploadFiles/MediaMessage.attachments/getMaxFileCount ships with the release these docs target.

Well-sourced, accurate PR. Ready to merge.

_{🤖 Automated docs review (Mintlify link/redirect/content checks + API verification against CometChatSDK iOS multi-attachment branch).}

[jitvarpatil]

Docs review — ✅ Approve

iOS multi-attachment docs — SDK upload-first flow + UIKit composer/bubble updates (6 files, +309/-27). No file deletions/nav change → no redirect risk. I verified the entire SDK API against the exact matching feature branch (ENG-36750/iossdk-multi-attachment-presigned-upload-support) — every symbol, signature, and default matches. Structurally clean.

✅ SDK API — verified against ENG-36750

• CometChat.uploadFiles(files:listener:) — real public API (CometChat+FileUpload.swift).
• MediaCallbackListener — upload listener with exactly the 4 documented methods: onSuccess(fileId:attachment:), onProgress(fileId:bytesUploaded:totalBytes:), onError(fileId:error:), onFailure(fileId:error:).
• MediaMessage.attachments: [Attachment]? — settable property (MediaMessage.swift:66), matching mediaMessage.attachments = uploadedAttachments.
• getMaxFileCount() → file.count.max, "Defaults to 10" (matches exactly); getMaxFileSize() → file.size.max (100 MB).
• sendMediaMessage, Attachment confirmed. The "leave files nil; an empty files array fails with invalid-message error" note is consistent with the file-count logic.

✅ Structure & UIKit

• 0 nav breaks, 0 orphans, 0 broken links in the changed files; all internal links resolve. (The 2 sdk/ios links the analyzer flagged — default-calling/login-listeners — are pre-existing in unchanged files, not send-message.mdx.)
• UIKit docs use the existing CometChatMessageComposer + attachmentOptions. No placeholders/TODOs.

Note

The SDK feature is on ENG-36750 (freshest branch) — i.e. this documents an in-progress feature. Please confirm the SDK version with uploadFiles/MediaMessage.attachments/getMaxFileCount ships with the release these docs target.

Well-sourced, accurate PR. Ready to merge.

_{🤖 Automated docs review (Mintlify link/redirect/content checks + API verification against CometChatSDK iOS multi-attachment branch).}

[jitvarpatil]

Re-review — 🟠 One thing to fix (image paths)

My earlier approval was auto-dismissed by the new commits, so re-reviewing on head c7c6026 (PR grew 6 → 13 files).

✅ API is correct — and it tracked an SDK refactor

The iOS SDK changed since my first review: uploadFiles(files:listener:) + MediaCallbackListener are gone, replaced by a request-based API — and these docs correctly follow it. Verified against ENG-36750/iossdk-multi-attachment-presigned-upload-support:

• createUploadFileRequest(receiverId:…) — CometChat+FileUpload.swift:25
• getMaxFileCount() -> Int (:35) and getMaxFileSize() -> Int (:50)
• UploadFileRequest.swift + UploadFileListener.swift (replacing the old MediaCallbackListener)

Platform-appropriate too: iOS keeps getMaxFileCount/getMaxFileSize, unlike Android's getMaxAttachmentCount and RN's async variant — nothing was blindly copied across platforms. 👍

Structure: sdk/ios/upload-files wired into nav; 0 nav breaks, 0 orphans, 0 broken links.

🟠 Please fix: the 4 bubble images are outside /images/ (likely to 404)

The new screenshots live at ui-kit/ios/multimediaAttachments/ and are referenced as /ui-kit/ios/multimediaAttachments/*.png — message-bubble-styling.mdx:230, 234, 272, 290.

This has no precedent in the repo:

• 2,932 image files — all under images/
• 3,275 image references in .mdx — all use /images (or /docs)
• The sibling PRs use the standard location: docs(android): enhance multimedia attachment #430 (Android) → images/audiobubble.png; docs(ui-kit/react-native): add multi attachment and plural media bubble docs for v5 #432 (RN) → images/rn_*_bubble.png

The files exist and the paths match, so this only renders if Mintlify serves static assets out of content directories — which nothing in this repo demonstrates. Safest fix: move the 4 PNGs to images/ (e.g. images/ios_audiobubble.png) and update the 4 src attributes. Cheap change, and it removes the risk of four broken screenshots in production.

🟡 Shared-image overwrite (third PR touching this asset)

images/multi_attachments_mobile.png pre-exists in main and this PR overwrites it (it's also referenced here by iOS core-features.mdx). #430 overwrites it as well, and main's RN core-features.mdx already uses it — so three PRs now share one asset. Worth deciding whether it's genuinely a cross-platform image or should be split per platform.

Everything else verifies — happy to approve once the images move under images/.

_{🤖 Automated docs review — re-check after new commits. API verified against CometChatSDK iOS multi-attachment branch.}

[jitvarpatil]

Re-review — ✅ Approve

Both items from my previous review are fixed. Re-verified on head de6689b.

✅ P1 (image paths) — fixed

• The non-standard ui-kit/ios/multimediaAttachments/ directory is gone; the 4 bubble images now live under images/ with iOS-specific names (images/ios_audiobubble.png, etc.).
• All image references in the changed iOS pages resolve, all under /images/. No lingering /ui-kit/ios/multimediaAttachments/ references anywhere.

✅ P2 (shared-image overwrite) — fixed

• iOS pages now use an iOS-specific overview image (images/ios_multi_attachments_mobile.png) — core-features.mdx:73.
• The shared images/multi_attachments_mobile.png is now byte-identical to main (net-zero — the earlier overwrite was reverted), so the RN page that shares it is no longer affected.

Everything else was already verified: the iOS SDK API (createUploadFileRequest, getMaxFileCount/getMaxFileSize, UploadFileRequest + UploadFileListener, MediaMessage.attachments) matches the ENG-36750 branch — the docs correctly tracked the SDK's refactor away from the old uploadFiles/MediaCallbackListener shape. Structure clean: nav wired, 0 broken links, 0 orphans.

Ready to merge. 🚀

_{🤖 Automated docs review — re-check after fixes.}

[jitvarpatil]

Re-review — ✅ Approve

Both items from my previous review are fixed. Re-verified on head de6689b.

✅ P1 (image paths) — fixed

• The non-standard ui-kit/ios/multimediaAttachments/ directory is gone; the 4 bubble images now live under images/ with iOS-specific names (images/ios_audiobubble.png, etc.).
• All image references in the changed iOS pages resolve, all under /images/. No lingering /ui-kit/ios/multimediaAttachments/ references anywhere.

✅ P2 (shared-image overwrite) — fixed

• iOS pages now use an iOS-specific overview image (images/ios_multi_attachments_mobile.png) — core-features.mdx:73.
• The shared images/multi_attachments_mobile.png is now byte-identical to main (net-zero — the earlier overwrite was reverted), so the RN page that shares it is no longer affected.

Everything else was already verified: the iOS SDK API (createUploadFileRequest, getMaxFileCount/getMaxFileSize, UploadFileRequest + UploadFileListener, MediaMessage.attachments) matches the ENG-36750 branch — the docs correctly tracked the SDK's refactor away from the old uploadFiles/MediaCallbackListener shape. Structure clean: nav wired, 0 broken links, 0 orphans.

Ready to merge. 🚀

_{🤖 Automated docs review — re-check after fixes.}