chat-sdk-flutter

Use when implementing login, logout, or session management with CometChat Flutter SDK v5. Triggers on mentions of CometChat.login(), loginWithAuthToken, getLoggedInUser, logout, auth tokens, createUser, or errors like ERR_ALREADY_LOGGED_IN, ERROR_USER_NOT_LOGGED_IN. Also use when the user is setting up user authentication flows, handling app resume sessions, or creating new CometChat users before login. Make sure to use this skill whenever the user mentions CometChat authentication, even if they just say 'connect the user', 'sign in to chat', or 'how do I log out'.

Use when combining multiple CometChat SDK methods for app flows like registration, conversation list updates, AI feature gating, or bootstrap sequences. Triggers on mentions of createUser then login, getConversation for patching, isAIFeatureEnabled, setSource, setPlatformParams, conversation list refresh on new message, or when building multi-step SDK integration flows.

Shared rules and patterns for any CometChat Flutter SDK v5 integration. Use as foundational context alongside a feature-specific skill. Do not use alone — pair with cometchat-flutter-init, cometchat-flutter-auth, cometchat-flutter-messaging, etc. Provides the Completer pattern, listener lifecycle rules, error handling conventions, and hard constraints that all feature skills inherit.

Use when handling CometChat errors in a Flutter app. Triggers on mentions of CometChatException, error codes like ERR_NOT_INITIALIZED, ERR_INVALID_APP_ID, ERROR_USER_NOT_LOGGED_IN, onError callbacks, or any CometChat error. Also use when the user asks about retry logic, error recovery, user-friendly error messages for chat failures, or why a CometChat method is throwing an exception. Make sure to use this skill whenever the user encounters a CometChat error or asks about graceful error handling, even if they just say 'my chat app keeps crashing' or 'how do I handle failures'.

Use when initializing the CometChat Flutter SDK v5 in any Flutter app. Triggers on any mention of CometChat.init(), AppSettingsBuilder, 'set up CometChat', 'integrate CometChat', or questions about why CometChat methods are failing before init completes. Also use when adding CometChat to a new project or troubleshooting 'SDK not initialized' errors. Make sure to use this skill whenever the user mentions CometChat setup, SDK initialization, AppSettings configuration, or encounters ERR_NOT_INITIALIZED errors, even if they don't explicitly say 'init'.

Use when sending or receiving messages with CometChat Flutter SDK v5. Triggers on mentions of TextMessage, MediaMessage, CustomMessage, sendMessage, sendMediaMessage, sendCustomMessage, MessageListener, MessagesRequest, MessagesRequestBuilder, fetchPrevious, fetchNext, editMessage, deleteMessage, or message pagination. Also use when the user asks about chat message delivery, editing or deleting messages, thread replies, or loading message history. Make sure to use this skill whenever the user mentions sending or receiving chat messages, even if they just say 'add chat functionality', 'display conversation', or 'load message history'.

Use when subscribing to real-time events with CometChat Flutter SDK v5. Triggers on mentions of MessageListener, UserListener, GroupListener, ConnectionListener, typing indicators, read receipts, delivery receipts, presence status, online/offline detection, startTyping, endTyping, markAsRead, markAsDelivered, or WebSocket connection state. Also use when the user asks about real-time updates, live message delivery, why presence events aren't working, or listener lifecycle management. Make sure to use this skill whenever the user mentions real-time chat features, listener registration, or event subscriptions, even if they just say 'show when user is typing' or 'detect online users'.

Integrate CometChat into any Flutter app. Auto-detects your project setup and walks you through adding chat — init, auth, messaging, groups, real-time events. Start here — do not invoke feature-specific skills directly. Trigger with "add CometChat to my Flutter app", "integrate CometChat", "set up chat in Flutter", or any mention of CometChat Flutter SDK.

Use when implementing group chat features with CometChat Flutter SDK v5. Triggers on mentions of Group, createGroup, joinGroup, leaveGroup, deleteGroup, GroupListener, GroupMember, member scope, kick, ban, unban, addMembersToGroup, GroupsRequestBuilder, GroupMembersRequestBuilder, or group CRUD operations. Also use when the user asks about public vs private groups, password-protected groups, managing group membership, or transferring group ownership. Make sure to use this skill whenever the user mentions group chat, channels, or multi-user conversations, even if they just say 'create a group chat' or 'add people to a room'.