cometchat-react-native-features
Turn a named CometChat capability on in a React Native app — look it up in the feature oracle, take the right enablement branch (already-on / dashboard extension / AI toggle / npm package / SDK fallback), and wire only what that branch needs. Triggers: enable reactions React Native, add polls RN chat, turn on smart replies RN, add voice video calling RN, enable message translation RN, add stickers RN, enable read receipts, typing indicator React Native, collaborative whiteboard.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- cometchat-react-native-features
- license
- MIT
- metadata
- { "tags": "chat cometchat react-native features extensions enablement dashboard ai calls", "author": "CometChat", "version": "1.0.0" }
- description
- Turn a named CometChat capability on in a React Native app — look it up in the feature oracle, take the right enablement branch (already-on / dashboard extension / AI toggle / npm package / SDK fallback), and wire only what that branch needs. Triggers: enable reactions React Native, add polls RN chat, turn on smart replies RN, add voice video calling RN, enable message translation RN, add stickers RN, enable read receipts, typing indicator React Native, collaborative whiteboard.
- compatibility
- React Native >=0.77; @cometchat/chat-uikit-react-native ^5.4.0; @cometchat/chat-sdk-react-native ^4.0.28
03 SKILL.md 正文
Ground truth:
features.rn-v5.json(48 entries) + catalogrn-v5.json. The oracle decides, not memory. Every claim below — whether a capability exists, whether it is on by default, which components render it — comes from that file. Fetch props viacore/references/docs-map.md.
Companion skills (read first)
cometchat-react-native-core— install, provider chain, init→login→render. Assumed, not repeated here.
Use this skill when
- "enable reactions / polls / translation / stickers" · "turn on smart replies"
- "add voice and video calling" · "is X supported" · "how do I switch on Y"
Prerequisites & install
None beyond core unless the feature's branch says otherwise (only two features install a package).
Step 1 — look the feature up in the oracle
Find the entry in features.rn-v5.json. If there is no entry, the feature does not exist — say so
rather than inventing an API. The entry tells you everything:
| Field | What it decides |
|---|---|
category · enablement |
which branch below to take |
ui_components |
what to render (all validated against the catalog) |
sdk_fallback |
the SDK methods to use when the kit has no component |
needs_stitching |
you must wire host state, not just drop a component in |
needs_dashboard |
a dashboard toggle is required as well as code |
auto_rendered_ui |
the kit renders it — emit no client code |
platform_delta |
how React Native differs from React here. Read it before writing anything. |
docs_gap |
the docs don't cover this yet — flag it, don't silently source-fill |
Step 2 — take exactly one branch
A. Already on — category: default, enablement: auto (12 features)
Nothing to enable. Reactions, mentions, typing indicators, receipts, threads and attachments are core messaging in v5, not extensions.
⚠️ Do not offer these as "enable this extension". The dashboard still lists legacy Reactions and Mentions extensions; their own docs say they are already part of core and scheduled for deprecation. Suggesting them is a bug, not a helpful extra — it is the exact defect the React pack hit (AUDIT-077). Customization is via component props, not enablement.
B. Dashboard extension — enablement: dashboard-extension (20 features)
Enable in the CometChat dashboard first, then wire any ui_components. Polls, stickers,
translation, link preview, whiteboard, document and similar. Without the dashboard step the code
compiles and silently does nothing.
Some are auto_rendered_ui: true (e.g. polls' bubble) — the message list renders them once enabled.
Emit no client code for those; hand-wiring produces a duplicate.
C. AI — category: ai, needs_dashboard: true (4 features)
Two steps, and the second is the one people miss: enable the feature in the dashboard and set the
code prop. The props default to off, so a dashboard-only change looks like nothing happened.
Smart replies, conversation starter, conversation summary, AI assistant.
Fetch the exact prop name from /ui-kit/react-native/ai-features.md — do not guess it.
D. npm package — enablement: npm-package (2 features)
Only calling. React Native needs its own calls SDK:
npm install @cometchat/calls-sdk-react-native@5 # + its 6 pinned peer deps — exact list in cometchat-react-native-calls
cd ios && pod install
⚠️ Not @cometchat/calls-sdk-javascript — that is the web package and will not work.
Its peers include react-native-webrtc, a native module: declare camera and microphone permissions
(NSCameraUsageDescription / NSMicrophoneUsageDescription; CAMERA / RECORD_AUDIO).
Simulators cannot capture camera or mic — calling must be verified on a real device.
Depth lives in cometchat-react-native-calls.
E. SDK fallback — the kit has no component (3 features)
Kit v5 removed the detail and management screens. sdk_fallback names the methods:
| Feature | Why | Use |
|---|---|---|
group-member-management |
no add/ban/transfer components | addMembersToGroup · banGroupMember · unbanGroupMember · transferGroupOwnership · BannedMembersRequestBuilder |
user-group-details |
no details component | getUser · getGroup · updateGroup |
call-log-details |
only the list ships | CometChatCalls.CallLogRequestBuilder (calls SDK) |
Banned members have no UI surface at all. An app that can ban but cannot view or unban is an unclosed round-trip — ship both halves.
Do not invent a layout: cite the official sample app's implementation
(github.com/cometchat/cometchat-uikit-react-native/tree/v5/examples/SampleApp). Those are sample-app
directory paths, never imports.
Step 3 — wire only what the branch needs
Render the entry's ui_components and nothing else. A feature that is auto_rendered_ui gets no
client code. A feature that is needs_stitching gets host state and callbacks wired, not just a mount.
Never enable a neighbouring feature because it seemed related — that is unrequested scope.
Known docs gaps (flag, don't silently source-fill)
reactions · typing-indicators · delivery-read-receipts · media-file-attachments (the whole
multi-attachment cluster) · and the three SDK-fallback features above carry a docs_gap marker.
Build from the catalog and kit source, and tell the developer the page is missing.
Common pitfalls
- Offering reactions/mentions as an extension — they are core in v5; the dashboard entries are legacy.
- Dashboard toggled, prop not set — AI features default to off in code.
- Installing the web calls SDK — RN has its own.
- Hand-wiring an
auto_rendered_uifeature — duplicate UI. - Assuming a feature exists — no oracle entry means no feature.
- Testing calls on a simulator — no camera or mic capture.
Verify it works
- The feature has an entry in
features.rn-v5.jsonand you took its branch. - Every emitted component appears in
catalogs/rn-v5.json. npm run verify:fences:rn-v5is green.- On device: the capability actually appears — a dashboard-gated feature with no code change, or a code change with no dashboard step, produces silence rather than an error.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.