@cometchat/skills 4.4.2 → 5.0.1

package/skills/cometchat-flutter-v5-calls/references/server-push-bridge.md

@@ -1,101 +0,0 @@
-# Server-side push routing for Flutter V5 (iOS PushKit + Android FCM)
-
-Same server architecture as React Native — your server uses the iOS APNs PushKit canonical for iPhones and the Android FCM HTTP v1 canonical for Android. Flutter-specific changes are in token registration on the client.
-
-**Canonical docs:**
-- iOS: `cometchat-ios-calls/references/server-apns-pushkit.md`
-- Android: `cometchat-android-v5-calls/references/server-fcm-voip.md`
-
----
-
-## Dependencies
-
-```yaml
-dependencies:
-  flutter_callkit_incoming: ^2.0.4
-  flutter_voip_pushkit: ^0.2.1
-  firebase_messaging: ^15.0.0
-```
-
----
-
-## Token registration (Flutter client)
-
-```dart
-import 'dart:io';
-import 'package:flutter_voip_pushkit/flutter_voip_pushkit.dart';
-import 'package:firebase_messaging/firebase_messaging.dart';
-
-class CallPushService {
-  Future<void> registerCallTokens(String userUid) async {
-    if (Platform.isIOS) {
-      final voip = FlutterVoipPushKit();
-      voip.onTokenRefresh.listen((token) async {
-        await api.registerCallToken(
-          uid: userUid,
-          platform: 'ios-voip',
-          token: token,
-        );
-      });
-      voip.onPushNotification.listen((payload) {
-        // flutter_callkit_incoming surfaces the OS UI from here
-      });
-      // Trigger token registration
-      await voip.configure();
-    } else if (Platform.isAndroid) {
-      final messaging = FirebaseMessaging.instance;
-      await messaging.requestPermission();
-      final token = await messaging.getToken();
-      if (token != null) {
-        await api.registerCallToken(
-          uid: userUid,
-          platform: 'android-fcm',
-          token: token,
-        );
-      }
-      messaging.onTokenRefresh.listen((newToken) async {
-        await api.registerCallToken(
-          uid: userUid,
-          platform: 'android-fcm',
-          token: newToken,
-        );
-      });
-    }
-  }
-}
-```
-
----
-
-## Server-side: same as RN
-
-Identical webhook + dispatcher to RN — the platform-specific server templates do all the work. See `cometchat-native-calls/references/server-push-bridge.md` for the dispatcher code.
-
----
-
-## Anti-patterns
-
-RN sister rules apply, plus Flutter-specific:
-
-1. **Calling `voip.configure()` before login.** Same problem as RN — register AFTER CometChat login.
-2. **Forgetting `firebase_messaging` background isolate setup.** Android background pushes when the app is killed need `FirebaseMessaging.onBackgroundMessage(handler)` registered in `main.dart` before `runApp`.
-3. **Skipping `flutter_callkit_incoming.showCallkitIncoming` in the push handler.** Without this, Flutter doesn't surface the OS-level call UI even though the push arrived.
-
----
-
-## Verification checklist
-
-- [ ] iOS: `FlutterVoipPushKit.configure()` + onTokenRefresh listener
-- [ ] Android: `FirebaseMessaging.instance.getToken()` + onTokenRefresh
-- [ ] Background isolate handler for Android (`onBackgroundMessage`)
-- [ ] Server has both APNs + FCM dispatchers
-- [ ] Real-device smoke: both iOS and Android ring when caller dials
-
----
-
-## Pointers
-
-- `cometchat-ios-calls/references/server-apns-pushkit.md` — iOS canonical
-- `cometchat-android-v5-calls/references/server-fcm-voip.md` — Android canonical
-- `cometchat-native-calls/references/server-push-bridge.md` — RN sister (same dispatcher pattern)
-- `cometchat-flutter-v5-calls` SKILL.md — Flutter calls architecture

package/skills/cometchat-flutter-v5-calls/references/share-invite.md

@@ -1,148 +0,0 @@
-# Share invite on Flutter V5 (GetX)
-
-Same SDK API. Flutter-specific: `share_plus` package wraps both iOS UIActivityViewController and Android Intent.ACTION_SEND under one cross-platform API.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/flutter/share-invite
-**Read first:** `cometchat-react-calls/references/share-invite.md` — deep-link rule, dialog UX.
-
----
-
-## Dependencies
-
-```yaml
-dependencies:
-  share_plus: ^10.0.0
-  uni_links: ^0.5.1   # for deep-link handling
-```
-
----
-
-## Hard rule: deep-link routing
-
-Configure both platforms:
-
-**iOS** (`ios/Runner/Info.plist`):
-```xml
-<key>com.apple.developer.associated-domains</key>
-<array><string>applinks:yourapp.com</string></array>
-```
-Plus apple-app-site-association on your domain (see iOS reference).
-
-**Android** (`android/app/src/main/AndroidManifest.xml`):
-```xml
-<activity android:name=".MainActivity" ...>
-  <intent-filter android:autoVerify="true">
-    <action android:name="android.intent.action.VIEW" />
-    <category android:name="android.intent.category.DEFAULT" />
-    <category android:name="android.intent.category.BROWSABLE" />
-    <data android:scheme="https"
-          android:host="yourapp.com"
-          android:pathPrefix="/call" />
-  </intent-filter>
-</activity>
-```
-
-Plus the corresponding `assetlinks.json` on your domain.
-
-Handle in app:
-```dart
-void initDeepLinks() {
-  uriLinkStream.listen((Uri? uri) {
-    if (uri == null) return;
-    if (uri.pathSegments.length >= 2 && uri.pathSegments[0] == 'call') {
-      final sessionId = uri.pathSegments[1];
-      Get.toNamed('/call/$sessionId');
-    }
-  });
-}
-```
-
----
-
-## SDK API
-
-```dart
-import 'package:cometchat_calls_sdk/cometchat_calls_sdk.dart';
-
-final settings = (SessionSettingsBuilder()
-      ..hideShareInviteButton(false))   // session_settings.dart:221
-    .build();
-
-// The share-invite tap arrives on ButtonClickListeners
-// (src/listener/button_click_listeners.dart:13), registered via
-// CallSession.getInstance()?.addButtonClickListener(...) (call_session.dart:90):
-@override
-void onShareInviteButtonClicked() {
-  Get.find<ShareInviteController>().share(sessionId);
-}
-```
-
----
-
-## share_plus
-
-```dart
-import 'package:share_plus/share_plus.dart';
-
-class ShareInviteController extends GetxController {
-  Future<void> share(String sessionId) async {
-    final url = 'https://yourapp.com/call/$sessionId';
-    final result = await Share.share(
-      "I'm on a call — tap to join.\n$url",
-      subject: 'Join my call',  // Android: title; iOS: ignored
-    );
-
-    if (result.status == ShareResultStatus.success) {
-      // logged + maybe haptic feedback
-    }
-    // dismissed/unavailable: silent
-  }
-}
-```
-
-`Share.share` opens iOS UIActivityViewController on iOS and the Android chooser on Android. The same call works on both.
-
----
-
-## iPad popover anchor
-
-`share_plus` requires a source rect on iPad:
-
-```dart
-final box = context.findRenderObject() as RenderBox?;
-await Share.share(
-  text,
-  sharePositionOrigin: box != null ? box.localToGlobal(Offset.zero) & box.size : null,
-);
-```
-
-Pass `sharePositionOrigin` from the button's render box. Without it, share sheet crashes on iPad.
-
----
-
-## Anti-patterns
-
-Web sister rules apply, plus Flutter-specific:
-
-1. **Calling `Share.share` without iPad anchor.** Crash on iPad in production.
-2. **Hard-coding URL.** Use `dotenv` or `--dart-define=APP_URL=...`.
-3. **No deep-link config for both platforms.** Only iOS works (or only Android), not both — partial UX.
-
----
-
-## Verification checklist
-
-- [ ] `share_plus` installed
-- [ ] Associated Domains (iOS) + auto-verified app links (Android) configured
-- [ ] `assetlinks.json` + `apple-app-site-association` hosted
-- [ ] `Share.share` called with `sharePositionOrigin` for iPad
-- [ ] App URL via env, not hard-coded
-- [ ] Real-device smoke: share via Messages on iOS, WhatsApp on Android → opens app
-
----
-
-## Pointers
-
-- `cometchat-react-calls/references/share-invite.md` — sister
-- `cometchat-flutter-v5-calls` SKILL.md
-- Canonical docs: https://www.cometchat.com/docs/calls/flutter/share-invite

package/skills/cometchat-flutter-v5-conversations/SKILL.md

@@ -1,118 +0,0 @@
----
-name: cometchat-flutter-v5-conversations
-description: "Use when working with CometChat Flutter UIKit v5 conversation list component. Triggers on CometChatConversations, conversation list, recent chats."
-license: "MIT"
-compatibility: "cometchat_chat_uikit ^5.2.14; cometchat_uikit_shared ^5.2.3"
-metadata:
-  author: "CometChat"
-  version: "3.0.0"
-  tags: "cometchat flutter v5 conversations list recent chats"
----
-
-> **Ground truth:** `cometchat_chat_uikit: ^5.2` (legacy/maintenance-only; calls via raw `cometchat_calls_sdk ^5.0.2`) — pub-cache source + `ui-kit/flutter/v5`. **Official docs:** https://www.cometchat.com/docs/ui-kit/flutter/v5/overview · **Docs MCP:** `claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp` (or fetch the URL directly without MCP). Verify symbols against the installed package/source before relying on them.
-
-# CometChat Flutter UIKit v5 — Conversations
-
-The `CometChatConversations` component displays a list of recent conversations.
-
-## Key Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `conversationsRequestBuilder` | `ConversationsRequestBuilder?` | — | Custom fetch builder |
-| `conversationsStyle` | `CometChatConversationsStyle` | `const CometChatConversationsStyle()` | Visual styling |
-| `onItemTap` | `Function(Conversation)?` | — | Tap callback (**no BuildContext**) |
-| `onItemLongPress` | `Function(Conversation)?` | — | Long press callback |
-| `subtitleView` | `Widget? Function(BuildContext, Conversation)?` | — | Custom subtitle |
-| `listItemView` | `Widget Function(Conversation)?` | — | Custom list item (replaces the whole row) |
-| `leadingView` | `Widget? Function(BuildContext, Conversation)?` | — | Custom leading widget (avatar slot) |
-| `titleView` | `Widget? Function(BuildContext, Conversation)?` | — | Custom title widget |
-| `trailingView` | `Widget? Function(Conversation)?` | — | Custom trailing widget (single-arg — asymmetric with the other slots) |
-| `title` | `String?` | — | List title |
-| `showBackButton` | `bool` | `false` | Show back button |
-| `onBack` | `VoidCallback?` | — | Back button callback |
-| `hideAppbar` | `bool?` | `false` | Hide app bar |
-| `appBarOptions` | `List<Widget>?` | — | App bar trailing widgets |
-| `usersStatusVisibility` | `bool?` | `true` | Show online status |
-| `receiptsVisibility` | `bool?` | `true` | Show read receipts |
-| `textFormatters` | `List<CometChatTextFormatter>?` | — | Text formatters for subtitles |
-| `controllerTag` | `String?` | — | Custom GetX controller tag |
-| `hideSearch` | `bool?` | — | Hide search bar |
-| `searchReadOnly` | `bool` | `false` | Read-only search |
-| `onSearchTap` | `GestureTapCallback?` | — | Search tap callback |
-| `deleteConversationOptionVisibility` | `bool?` | `true` | Show delete option |
-| `loadingStateView` | `WidgetBuilder?` | — | Custom loading state |
-| `emptyStateView` | `WidgetBuilder?` | — | Custom empty state |
-| `errorStateView` | `WidgetBuilder?` | — | Custom error state |
-| `setOptions` | `Function?` | — | Replace long-press options |
-| `addOptions` | `Function?` | — | Add to long-press options |
-
-## Basic Usage
-
-```dart
-CometChatConversations(
-  onItemTap: (conversation) {
-    User? user;
-    Group? group;
-    if (conversation.conversationWith is User) {
-      user = conversation.conversationWith as User;
-    } else {
-      group = conversation.conversationWith as Group;
-    }
-    Navigator.push(context, MaterialPageRoute(
-      builder: (_) => MessagesScreen(user: user, group: group),
-    ));
-  },
-)
-```
-
-## Custom Request Builder
-
-```dart
-CometChatConversations(
-  conversationsRequestBuilder: ConversationsRequestBuilder()
-    ..limit = 30
-    ..conversationType = ConversationType.user,
-)
-```
-
-## Internal Architecture (GetX)
-
-The component creates `CometChatConversationsController` via `Get.put()` in `initState()` and deletes it in `dispose()` (unless `controllerTag` is provided externally).
-
-Theme values are cached in `didChangeDependencies()` (unconditionally, no flag):
-```dart
-@override
-void didChangeDependencies() {
-  typography = CometChatThemeHelper.getTypography(context);
-  colorPalette = CometChatThemeHelper.getColorPalette(context);
-  spacing = CometChatThemeHelper.getSpacing(context);
-  style = CometChatThemeHelper.getTheme<CometChatConversationsStyle>(
-      context: context, defaultTheme: CometChatConversationsStyle.of)
-    .merge(widget.conversationsStyle);
-  super.didChangeDependencies();
-}
-```
-
-## Anti-Patterns
-
-```dart
-// ❌ WRONG — trying to access controller before component mounts
-final controller = Get.find<CometChatConversationsController>();
-
-// ❌ WRONG — manually creating controller outside the widget
-Get.put(CometChatConversationsController(...));
-
-// ❌ WRONG — not extracting User/Group from conversation
-onItemTap: (conversation) {
-  Navigator.push(context, MaterialPageRoute(
-    builder: (_) => MessagesScreen(user: conversation.conversationWith), // Type error
-  ));
-}
-```
-
-## Checklist — Conversations
-
-- [ ] `onItemTap` extracts `User`/`Group` from `conversation.conversationWith` with type check
-- [ ] Navigation to messages screen passes extracted `user` or `group`
-- [ ] Let the widget manage its own GetX controller lifecycle

package/skills/cometchat-flutter-v5-core/SKILL.md

@@ -1,239 +0,0 @@
----
-name: cometchat-flutter-v5-core
-description: "Use when writing any code that uses CometChat Flutter UIKit v5 (cometchat_chat_uikit v5.2.14, cometchat_calls_uikit v5.0.15, cometchat_uikit_shared v5.2.3). Contains hard rules that prevent silent failures."
-license: "MIT"
-compatibility: "cometchat_chat_uikit ^5.2.14; cometchat_calls_uikit ^5.0.15; cometchat_uikit_shared ^5.2.3; cometchat_sdk ^4.1.2; get ^4.6.5"
-metadata:
-  author: "CometChat"
-  version: "3.0.0"
-  tags: "cometchat flutter v5 core rules init login logout lifecycle getx"
----
-
-# CometChat Flutter UIKit v5 — Core Rules
-
-> **Ground truth:** `cometchat_chat_uikit: ^5.2` (GetX-based; pair with `cometchat_calls_uikit: ^5.0` / raw `cometchat_calls_sdk ^5.0.2` for calls) — the pub-cache package source + `docs/ui-kit/flutter/v5`. **Official docs:** https://www.cometchat.com/docs/ui-kit/flutter/v5/overview · **Docs MCP:** `claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp` (or fetch the URL directly without MCP). V5 is legacy/maintenance-only (V6 is current); verify Dart symbols against the resolved package source.
-
-Non-negotiable constraints for all CometChat UIKit v5 code. Violating these causes silent failures or crashes.
-
-## Key v5 Architecture Facts
-
-- State management: **GetX** (GetBuilder, GetxController, Get.put, Get.find, Get.delete)
-- Separate packages: `cometchat_chat_uikit` + `cometchat_calls_uikit` + `cometchat_uikit_shared`
-- SDK: `cometchat_sdk ^4.1.2` + `cometchat_calls_sdk ^4.2.2` (chat-kit baseline). **For voice/video calling, do NOT use `cometchat_calls_uikit` (4.x-bound) — integrate the raw `cometchat_calls_sdk ^5.0.2` per `cometchat-flutter-v5-calls`** (the V5-canonical calls path).
-- **Imports — two barrels.** For chat-only projects: `package:cometchat_chat_uikit/cometchat_chat_uikit.dart`. For projects that also need voice/video calling: ADD `package:cometchat_calls_uikit/cometchat_calls_uikit.dart` as a SECOND import — the calls barrel re-exports shared + SDK only and does NOT re-export `cometchat_chat_uikit`. Chat widgets like `CometChatConversations`, `CometChatMessageList`, `CometChatMessageComposer` are reachable only through the chat barrel.
-- `CometChatUIKit.login(uid)` takes a **String** directly (not an object)
-- No ServiceLocator pattern — controllers are created via `Get.put()` internally
-- Style classes use `ThemeExtension` with `merge()` pattern
-
-## Rule: INIT_FIRST
-
-`CometChatUIKit.init()` must complete before any login, component usage, or SDK call.
-
-```dart
-// ✅ CORRECT
-final settings = (UIKitSettingsBuilder()
-      ..appId = 'APP_ID'
-      ..region = 'us'
-      ..authKey = 'AUTH_KEY'
-      ..subscriptionType = CometChatSubscriptionType.allUsers)
-    .build();
-
-CometChatUIKit.init(
-  uiKitSettings: settings,
-  onSuccess: (_) => debugPrint('Init done'),
-  onError: (e) => debugPrint('Init failed: ${e.message}'),
-);
-
-// ❌ WRONG — login before init completes
-CometChatUIKit.init(uiKitSettings: settings);
-CometChatUIKit.login('uid'); // Race condition
-```
-
-## Rule: AUTH_CHECK_AFTER_INIT
-
-After `CometChatUIKit.init()` completes, the static field `CometChatUIKit.loggedInUser` is populated if a cached session exists (init internally calls `getLoggedInUser()`). You can check it synchronously in `onSuccess`, or use `CometChatUIKit.getLoggedInUser()` for an explicit async check.
-
-```dart
-// ✅ CORRECT — synchronous check after init
-CometChatUIKit.init(
-  uiKitSettings: settings,
-  onSuccess: (_) {
-    final hasUser = CometChatUIKit.loggedInUser != null;
-    // Route to home or login
-  },
-);
-
-// ✅ ALSO CORRECT — explicit async check (used by master app)
-CometChatUIKit.init(
-  uiKitSettings: settings,
-  onSuccess: (_) async {
-    final user = await CometChatUIKit.getLoggedInUser();
-    if (user != null) {
-      await CometChatUIKit.login(user.uid, onSuccess: ...);
-    }
-  },
-);
-```
-
-Note: `CometChatUIKit.login()` handles re-login gracefully — if the user is already logged in with the same UID, it returns the cached user without hitting the server.
-
-## Rule: LISTENER_LIFECYCLE
-
-SDK listeners MUST be registered with a unique ID in `initState()` (or GetxController `onInit()`) and removed in `dispose()` (or `onClose()`).
-
-```dart
-// ✅ CORRECT
-class _MyScreenState extends State<MyScreen> with MessageListener {
-  late final String _listenerId;
-
-  @override
-  void initState() {
-    super.initState();
-    _listenerId = 'my_screen_${DateTime.now().millisecondsSinceEpoch}';
-    CometChat.addMessageListener(_listenerId, this);
-  }
-
-  @override
-  void dispose() {
-    CometChat.removeMessageListener(_listenerId);
-    super.dispose();
-  }
-}
-
-// ❌ WRONG — hardcoded ID causes collisions; missing dispose removal
-CometChat.addMessageListener('messages', this); // Collision!
-```
-
-## Rule: THEME_CACHE
-
-Cache theme values in `didChangeDependencies()` — unconditionally, no flag needed. Never call `CometChatThemeHelper.getColorPalette(context)` in `build()`.
-
-`getColorPalette()` creates a new `CometChatColorPalette` object every call, resolving each token individually via `Theme.of(context)`. During keyboard animation, `MediaQuery` changes trigger rebuilds, making this expensive in `build()`.
-
-```dart
-// ✅ CORRECT — matches actual package pattern (no flag)
-@override
-void didChangeDependencies() {
-  super.didChangeDependencies();
-  colorPalette = CometChatThemeHelper.getColorPalette(context);
-  spacing = CometChatThemeHelper.getSpacing(context);
-  typography = CometChatThemeHelper.getTypography(context);
-}
-
-// ❌ WRONG — lookup in build causes jank
-@override
-Widget build(BuildContext context) {
-  final colors = CometChatThemeHelper.getColorPalette(context); // Expensive!
-  return Container(color: colors.primary);
-}
-```
-
-Do NOT use a `_themeInitialized` flag — it prevents theme updates when the system switches between light/dark mode.
-
-## Rule: SUBSCRIPTION_TYPE_REQUIRED
-
-Omitting `subscriptionType` in `UIKitSettingsBuilder` silently disables all presence events (online/offline, typing indicators). No error is thrown.
-
-```dart
-// ✅ CORRECT
-UIKitSettingsBuilder()
-  ..subscriptionType = CometChatSubscriptionType.allUsers
-```
-
-## Rule: REGION_LOWERCASE
-
-Region must be a lowercase string: `'us'`, `'eu'`, or `'in'`.
-
-## Rule: MUID_PRESERVATION
-
-When handling `ccMessageSent` events, compare by `muid` first, then `id` — the SDK may return an empty `muid` in the success callback.
-
-## Pattern: Callback → Async Bridge (Completer)
-
-```dart
-import 'dart:async';
-
-Future<bool> initAsync(UIKitSettings settings) {
-  final completer = Completer<bool>();
-  CometChatUIKit.init(
-    uiKitSettings: settings,
-    onSuccess: (_) => completer.complete(true),
-    onError: (e) => completer.complete(false),
-  );
-  return completer.future;
-}
-```
-
-## v5 Component Architecture Pattern (GetX)
-
-```
-{component}/
-├── cometchat_{component}.dart              # StatefulWidget
-├── cometchat_{component}_controller.dart   # extends GetxController
-├── cometchat_{component}_style.dart        # ThemeExtension with merge()
-└── {component}_builder_protocol.dart       # Request builder protocol
-```
-
-Internal lifecycle:
-```dart
-@override
-void initState() {
-  super.initState();
-  tag = widget.controllerTag ?? 'default_tag_${DateTime.now().millisecondsSinceEpoch}';
-  controller = Get.put<Controller>(Controller(...), tag: tag);
-}
-
-@override
-void dispose() {
-  if (widget.controllerTag == null) {
-    Get.delete<Controller>(tag: tag);
-  }
-  super.dispose();
-}
-```
-
-## Android Build Requirements
-
-- `android.useAndroidX=true` and `android.enableJetifier=true` in `gradle.properties`
-- `minSdk 26` in `android/app/build.gradle`
-- ProGuard: `-keep class com.cometchat.** { *; }` and `-keep interface com.cometchat.** { *; }`
-
-## Top 10 Error Debugging
-
-| Symptom | Cause | Fix |
-|---------|-------|-----|
-| "Authentication null" | `CometChatUIKit.init()` not called | Call init before login/components |
-| "APP ID null" | appId not set in UIKitSettingsBuilder | Set `..appId = 'YOUR_APP_ID'` |
-| No typing indicators / presence | `subscriptionType` not set | Set `..subscriptionType = CometChatSubscriptionType.allUsers` |
-| Theme jank during keyboard | Theme looked up in `build()` | Cache in `didChangeDependencies()` |
-| Listener leak / duplicate events | Listener not removed in `dispose()` | Always remove with same ID |
-| GetX controller not found | Using `Get.find()` before `Get.put()` | Let UIKit components manage their own controllers |
-| Region error | Uppercase region string | Use lowercase: 'us', 'eu', 'in' |
-| Release build crash | Missing ProGuard keep rules | Add `-keep class com.cometchat.** { *; }` |
-
-## Checklist — Every CometChat v5 Screen
-
-- [ ] `CometChatUIKit.init()` called before any usage
-- [ ] `subscriptionType` set in UIKitSettingsBuilder
-- [ ] `region` is lowercase
-- [ ] Theme cached in `didChangeDependencies()`, not `build()`
-- [ ] SDK listeners registered with unique ID, removed in `dispose()`
-- [ ] Colors from `CometChatThemeHelper`, never hardcoded
-- [ ] Imports: `package:cometchat_chat_uikit/cometchat_chat_uikit.dart` always; ADD `package:cometchat_calls_uikit/cometchat_calls_uikit.dart` if you use voice/video
-
-## Visual Builder integration
-
-**Flutter V5 is the primary home for Visual Builder integration.** The canonical repo at the `chat_builder/` directory inside the Flutter Visual Builder ZIP (download from https://preview.cometchat.com/downloads/cometchat-builder-flutter.zip) ships **V5-shaped code** — `cometchat_chat_uikit: ^5.2.12` + `cometchat_calls_uikit: ^5.0.13`. The integration copies the entire `chat_builder/` directory as a `path:` dependency, then `BuilderSettingsHelper.loadFromAsset()` reads `chat_builder/assets/sample_app/cometchat-builder-settings.json` and configures the bundled chat UI accordingly.
-
-**The full recipe lives in `cometchat-flutter-v6-core` §"Visual Builder integration"** because that's where the V6-prep restructure originally landed the validated content. Both skills reference the same canonical; the V6 page carries a "V5-shaped code" warning at the top. V5 customers should follow that recipe AS-IS — the canonical IS V5-targeted.
-
-Validated 2026-05-21 against Flutter 3.38.3: `flutter build apk --debug` produces `app-debug.apk` after applying:
-- Envelope-wrapped JSON at `chat_builder/assets/sample_app/cometchat-builder-settings.json`. The CLI (source of truth) writes `{ builderId, name, settings: {...} }`; the vendor canonical's own checked-in file carries only `{ builderId, settings }` (no `name`). `BuilderSettingsHelper.loadFromAsset()` reads only `builderId` + `settings` and ignores any extra top-level keys, so the CLI's extra `name` is harmless.
-- Two missing-field defaults injected pre-write (mentionAll + inAppSounds — same as Android)
-- `android.enableJetifier=true` in `android/gradle.properties` (the chat SDK pulls `com.android.support` transitively)
-- `await BuilderSettingsHelper.loadFromAsset()` in `lib/main.dart` before `runApp()`
-- `chat_builder: { path: ./chat_builder }` in host `pubspec.yaml`
-
-Differences from the V6 page's recipe text:
-- V5 host code uses `StatefulWidget` with direct listener management (V6 uses BLoC pattern); both work with the embedded chat_builder package since it owns its own state.
-- V5 calls (the standalone `cometchat-flutter-v5-calls` flow, outside the builder) don't need the [[project_v6_flutter_calls_partial]] navigatorKey workaround — that's a V6-specific incoming-call-routing requirement. **However, the Visual Builder canonical itself (V5-shaped) wires `navigatorKey: CallNavigationContext.navigatorKey` UNCONDITIONALLY in every `MaterialApp` `ChatBuilder.createApp()` builds**, regardless of whether calls are enabled — so if you mount `ChatBuilder.createApp()` (recommended) or replicate its `MaterialApp` in a host wrapper, keep that navigator key in place. Do NOT gate it behind "calls enabled". See the v6-core recipe's wrapper guidance.