Skip to content

docs(flutter): Add custom mentions formatter guide with filtering exa…#326

Merged
swapnil-cometchat merged 1 commit intomainfrom
feature/flutter-uikit-v5-custom-mentions-formatter
Apr 8, 2026
Merged

docs(flutter): Add custom mentions formatter guide with filtering exa…#326
swapnil-cometchat merged 1 commit intomainfrom
feature/flutter-uikit-v5-custom-mentions-formatter

Conversation

@anshuman-cometchat
Copy link
Copy Markdown
Contributor

Summary

  • Add new custom-mentions-formatter-guide.mdx with complete implementation walkthrough
  • Document how to extend CometChatMentionsFormatter to filter suggestions and handle tap interactions
  • Include mermaid flowchart explaining the filtering proxy pattern
  • Add _FilteredSuggestionSink wrapper class example that removes logged-in user from mentions
  • Update docs.json to register new guide in Flutter documentation navigation
  • Update mentions-formatter-guide.mdx with cross-reference to custom formatter guide
  • Update custom-text-formatter-guide.mdx with related links section
  • Provide setup instructions, use case explanation, and step-by-step implementation guide
  • Target v5.2.13 and above with version compatibility warning

Description

Adds a new documentation page for creating a custom mentions formatter in the CometChat Flutter UI Kit (v5). The guide walks developers through extending CometChatMentionsFormatter to customize @mention suggestion behavior — filtering who appears in the suggestion list, styling mentions, and handling tap interactions. The implementation uses a StreamSink proxy pattern to intercept and filter suggestions before they reach the UI. All code examples have been verified against the actual UI Kit source (cometchat_chat_uikit v5.2.13). Cross-links have been added to the existing mentions formatter and custom text formatter pages.

Related Issue(s)

N/A

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

  • All code snippets verified against the cometchat_chat_uikit source (v5.2.13)
  • Property names (mentionSelfTextColor, mentionTextColor, etc.) match CometChatMentionsStyle exactly
  • SuggestionListItem fields (id, title, data, etc.) verified against source
  • Composer widget parameters (textFormatters, disableMentions, parentMessageId) confirmed in both CometChatMessageComposer and CometChatCompactMessageComposer
  • Custom formatter class matches the reference implementation in master_app/lib/utils/custom_mentions_formatter.dart

…mple

- Add new custom-mentions-formatter-guide.mdx with complete implementation walkthrough
- Document how to extend CometChatMentionsFormatter to filter suggestions and handle tap interactions
- Include mermaid flowchart explaining the filtering proxy pattern
- Add _FilteredSuggestionSink wrapper class example that removes logged-in user from mentions
- Update docs.json to register new guide in Flutter documentation navigation
- Update mentions-formatter-guide.mdx with cross-reference to custom formatter guide
- Update custom-text-formatter-guide.mdx with related links section
- Provide setup instructions, use case explanation, and step-by-step implementation guide
- Target v5.2.13 and above with version compatibility warning
@mintlify
Copy link
Copy Markdown

mintlify bot commented Apr 8, 2026

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

Project Status Preview Updated (UTC)
cometchat 🟢 Ready View Preview Apr 8, 2026, 1:02 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@swapnil-cometchat swapnil-cometchat merged commit b1817c7 into main Apr 8, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

4 participants