v4.3.0
Released: 2026-05-29
New
- Added Visual Builder integration across React, React Native, native Android, native iOS, and Flutter workflows. The
/cometchat add chat to my appflow now offers a choice between visual customization in the CometChat dashboard or code-driven setup directly in the IDE. - Added browser-driven Visual Builder workflows that automatically create builder instances, open the dashboard editor, fetch generated configuration data, and emit production-ready integrations directly into existing projects without requiring manual ZIP downloads or file copying.
- Added platform-specific Visual Builder integration recipes for React, React Native, Android V6, Flutter V6, and iOS applications using canonical builder application structures and verified configuration patterns.
- Added the
cometchat builder create,cometchat builder fetch, andcometchat builder listCLI commands for managing Visual Builder instances directly from the terminal. - Added
cometchat verify --builderto validate Visual Builder integrations across supported platforms, including settings files, wrapper components, dependency wiring, and generated application structure checks. - Added support for re-syncing existing Visual Builder integrations through the
/cometchatiteration flow, allowing updated dashboard customizations to be pulled into existing applications without overwriting user-modified files. - Added canonical Visual Builder integration guidance across core skills for React, React Native, Android, Flutter, and iOS platforms.
- Added end-to-end smoke-test coverage for Visual Builder integrations across React, React Native, Android V6, and Flutter V6 workflows.
Enhancements
- Improved Angular onboarding flows by detecting unsupported Visual Builder scenarios and automatically falling back to code-driven integrations with explicit guidance.
- Improved configuration persistence by adding
productandcustomizekeys to.cometchat/config.json, allowing reruns to skip repeated setup prompts. - Improved dispatcher reliability by documenting and handling Visual Builder edge cases including expired builders, missing permissions, browser launch failures, stale configuration state, and active-builder conflicts.
- Improved React Router v7 and Vite 7 compatibility by updating generated integrations to use type-safe import patterns compatible with Rolldown-based builds.
- Improved Next.js compatibility by detecting unsupported Pages Router CSS-import patterns before emitting invalid integrations.
- Improved Flutter V6 integration support by updating Visual Builder and calls workflows to use the stable
6.0.1release instead of earlier beta builds. - Improved feature-removal workflows by extending
cometchat apply-feature --removesupport across all supported feature categories. - Improved Windows installation reliability by hardening
npxprocess spawning behavior for environments where.cmdand PowerShell wrappers fail. - Improved React Native calls integration by wiring incoming, outgoing, and ongoing call surfaces across both SDK socket listeners and UI event channels.
- Improved React Native installation guidance by documenting additional required peer dependencies for calls SDK polyfills and runtime compatibility.
Fixes
- Fixed Visual Builder initialization failures caused by existing active builders on the same app. Builder creation now reuses active builders automatically unless
--forceis specified. - Fixed Android Visual Builder integrations where missing JSON envelope wrappers caused generated
CometChatBuilderSettingsclasses to compile without required constants. - Fixed iOS, Android, and Flutter Visual Builder integrations that silently fell back to default configurations when settings files omitted the required
{ builderId, name, settings }envelope structure. - Fixed missing dashboard API response fields for
chatFeatures.inAppSoundsandchatFeatures.deeperUserEngagement.mentionAllby injecting safe defaults during settings generation. - Fixed Vite 7 and newer TypeScript build failures caused by stricter compiler defaults in generated React integrations.
- Fixed React integrations that failed when
package.jsonomitted the requiredcometChatCustomConfigblock expected by the canonical builder context. - Fixed incorrect
useConfigselector examples in React Native guidance that referenced a non-existent.configwrapper in the application state shape. - Fixed false-positive validation failures in
verify --builderfor valid dependency graphs, settings formats, Android View-based integrations, Flutter settings paths, and alternate Flutter initialization patterns. - Fixed React Native calls flows where outgoing and ongoing call screens failed to mount after call acceptance.
- Fixed React Native initialization flows where
getLoggedInUser()threw aNOT_FOUNDerror instead of returningnullwhen no active session existed. - Fixed Visual Builder integrations for React Router v7 projects by replacing unsupported type-as-value imports rejected by Rolldown builds.
- Fixed Flutter V6 outgoing-call transitions that previously failed to move from ringing to active in-call surfaces before the stable
6.0.1release. - Fixed Windows installer failures where
spawn npx ENOENTerrors prevented skill installation in certain shell environments. - Fixed YAML frontmatter parsing failures in calls-related skills caused by unquoted inline colon-space mappings.
Compatibility
- Supported Node.js 18 and later, including Angular CLI workflows on Node.js 20.19+ and 22.12+.
- Supported React 18 and React 19, including Visual Builder integrations using
@cometchat/chat-uikit-react@6.4.3. - Supported Next.js 13 and later with both App Router and Pages Router detection flows.
- Supported React Router v6 and v7.
- Supported Astro 4 and later.
- Supported Expo SDK 49 and later, including SDK 54 validation for Visual Builder workflows.
- Supported React Native 0.70 and later, including validation on React Native 0.85.
- Supported Angular 12 through 21, with Visual Builder integrations automatically falling back to code-driven setup.
- Supported Android V5 stable and Android V6 Compose and Views integrations using Gradle plugin
5.0.1. - Supported native iOS V5 integrations, excluding pending Visual Builder updates requiring
CometChatBuilder > 1.1.2. - Supported Flutter V5 and Flutter V6 integrations, including production-ready V6 calls support on
6.0.1.
Known Issues
- Known issues remain for bare React Native projects using
@cometchat/chat-sdk-react-native@4.0.22, where nested React Native dependency installation can cause AsyncStorage module mismatches at startup. - Known issues remain for iOS Visual Builder integrations pending a future
CometChatBuilderrelease that includesLayout.compactMessageComposer. - Known issues remain for non-blocking React Native Expo startup promise rejections caused by unresolved Hermes bytecode source maps.
- Known issues remain for native iOS V5 calls integrations while the required WebRTC binary package remains unavailable from Cloudsmith.
- Known issues remain for dashboard API responses that omit certain Visual Builder configuration fields, although default values are now injected automatically during integration generation.
Upgrade
- Updated installations to
@cometchat/skills@4.3.0usingnpm install @cometchat/skills@latestor by runningnpx @cometchat/skills@4.3.0 add. - Confirmed that all existing v4.2.x code-driven integrations continue to function without modification unless the Visual Builder workflow is explicitly selected.
- Confirmed that rerunning
/cometchatagainst existing integrations safely detects previously generated files and prompts before applying changes.