Managing Groups in Flutter UI Kit

​

Overview

• Create or join public/private/password-protected groups
• View and manage group members
• Assign roles and moderate participants
• Transfer group ownership for continuity

​

Prerequisites

• CometChat UIKit for Flutter installed via pubspec.yaml
• CometChat initialized with App ID, Region, and Auth Key
• Group chat enabled in your CometChat app
• Navigation set up between group/member screens
• Internet permissions

​

Components

​

Integration Steps

​

Create a Group

IconButton(
  onPressed: () {
    showCreateGroup(
      context: context,
      colorPalette: colorPalette,
      typography: typography,
      spacing: spacing,
    );
  },
  icon: Icon(Icons.group_add),
);

ElevatedButton(
  onPressed: () async {
    await CometChat.createGroup(
      group: Group(
        guid: groupId,
        name: groupName,
        type: groupType,
        password: groupPassword,
      ),
      onSuccess: (Group group) => Navigator.pop(context),
      onError: (e) {
        // Show error
      },
    );
  },
  child: Text('Create Group'),
);

​

Join Public/Password Group

CometChatGroups(
  onItemTap: (context, group) {
    JoinProtectedGroupUtils.onGroupItemTap(context, group, ...);
  },
);

if (group.type == GroupType.password) {
  // Show password prompt
  // Join via CometChat.joinGroup with password
}

​

View Members

CometChatGroupInfo(
  group: group,
);

​

Add Members

CometChatAddMembers(
  group: group,
);

​

Ban/Unban Members

CometChatBannedMembers(
  group: group,
);

​

Change Member Scope

CometChatChangeScope(
  group: group,
  user: user,
);

​

Transfer Ownership

CometChatTransferOwnership(
  group: group,
);

​

Implementation Flow

1. User creates or joins a group
2. Admin views group info and member list
3. Admin can add, ban, change scope, or transfer ownership

​

Customization Options

• Modify theme using CometChat UIKit theming APIs
• Add logic to validate group name or enforce limits
• Adjust member filters or role options as needed

​

Filtering / Edge Cases

• Filter by roles or banned status
• Prevent duplicate group IDs
• Prevent banning owner or transferring to non-member

​

Error Handling & Blocked Users

• Show UI feedback (SnackBars) on failure
• Blocked users cannot be added or may be auto-banned
• Retry logic for failed actions (create, join, etc.)

​

Group Type Notes

• Public: anyone can join
• Password: prompt required
• Private: invite-only
• Only admins can ban, change roles, or transfer ownership

​

Summary / Feature Matrix

​

Next Steps & Further Reading