[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MFGDKXPE6EX9DM30DD18KW":3,"skill-same:01M6MFGDKXPE6EX9DM30DD18KW":79},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":55,"commitSha":56,"skillDirectory":57,"forksCount":58,"repositoryHtmlUrl":59,"repositoryHomepageUrl":60,"ownerHtmlUrl":61,"ownerBlogUrl":62,"ownerDescription":63,"updatedAt":64,"install":65,"resources":78},"01M6MFGDKXPE6EX9DM30DD18KW","cometchat-react-native-expo-patterns",null,"Expo-specific wiring for the CometChat React Native UI Kit v5 — why Expo Go cannot work, development builds, app.json permissions, and the Expo-only extra dependency. Triggers: CometChat in Expo, Expo chat app, expo development build CometChat, Expo Go chat not working, expo run ios CometChat.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-react-native-expo-patterns\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"react","cometchat","cometchat react native expo patterns","react native expo","native","patterns","expo","react native","only","dependency","react-native","work","why","run ios","app","ui","permissions","kit","wiring","run","go","2026-11-10 10:12:30",false,"---\nname: cometchat-react-native-expo-patterns\ndescription: \"Expo-specific wiring for the CometChat React Native UI Kit v5 — why Expo Go cannot work, development builds, app.json permissions, and the Expo-only extra dependency. Triggers: CometChat in Expo, Expo chat app, expo development build CometChat, Expo Go chat not working, expo run ios CometChat.\"\nlicense: \"MIT\"\ncompatibility: \"Expo SDK >=53 (development builds; ships React Native 0.79 — SDK 52 ships RN 0.76, below the pack's RN floor); React Native >=0.77; @cometchat\u002Fchat-uikit-react-native ^5.4.0\"\nmetadata:\n  author: \"CometChat\"\n  version: \"1.0.0\"\n  tags: \"chat cometchat react-native expo development-build app-json permissions\"\n---\n\n> **Ground truth:** `@cometchat\u002Fchat-uikit-react-native@5` + catalog `rn-v5.json`.\n> Docs: `\u002Fui-kit\u002Freact-native\u002Fexpo-integration` · `expo-conversation` · `expo-tab-based-chat`.\n\n## Companion skills (read first)\n- `cometchat-react-native-core` — install, provider chain, init→login→render. Assumed, not repeated here.\n- `cometchat-react-native-bare-patterns` — the bare React Native CLI equivalent. Use that one, not this, for a non-Expo app.\n\n## Use this skill when\n- the project has `app.json`\u002F`app.config.js` with an `expo` key, or `expo` in `package.json`\n- \"add chat to my Expo app\" · \"chat isn't working in Expo Go\"\n\n## Prerequisites & install\n\n### ⚠️ Expo Go does not work — and this is the #1 support issue\nThe UI Kit ships **custom native modules**. Expo Go is a fixed prebuilt binary that cannot load them.\nThere is no workaround, no config flag, and nothing to fix in code. You need a **development build**.\n\nSymptom: the app runs in Expo Go but chat screens crash or render nothing, with a NativeModule error\nthat names `gesture-handler` \u002F `svg` \u002F `video` rather than CometChat — so it reads as unrelated.\n\n```bash\nnpx expo run:ios      # or: npx expo run:android\n```\n\nBoth produce a development build. From then on use that build, not Expo Go.\n\n### Packages\nSame list as bare RN, **plus `punycode`, which is Expo-only**:\n\n```bash\nnpm install @cometchat\u002Fchat-uikit-react-native@5 @cometchat\u002Fchat-sdk-react-native@4\nnpm install @react-native-clipboard\u002Fclipboard \\\n  react-native-svg react-native-video react-native-localize react-native-gesture-handler \\\n  react-native-safe-area-context @react-native-async-storage\u002Fasync-storage@^2.1.2 dayjs punycode\n```\n\n## Native config lives in `app.json` — never in ios\u002F or android\u002F\n\nThis is the whole Expo\u002Fbare divergence: Expo **generates** the native projects, so hand-editing\n`Info.plist` or `AndroidManifest.xml` is pointless — the next prebuild overwrites it. Declare\npermissions in `app.json` and let Expo write them:\n\n```json\n{\n  \"expo\": {\n    \"ios\": {\n      \"infoPlist\": {\n        \"NSCameraUsageDescription\": \"Camera access for video calls\",\n        \"NSMicrophoneUsageDescription\": \"Microphone access for voice\u002Fvideo calls\"\n      }\n    },\n    \"android\": {\n      \"permissions\": [\n        \"android.permission.INTERNET\",\n        \"android.permission.CAMERA\",\n        \"android.permission.MODIFY_AUDIO_SETTINGS\",\n        \"android.permission.RECORD_AUDIO\",\n        \"android.permission.ACCESS_NETWORK_STATE\",\n        \"android.permission.BLUETOOTH_CONNECT\",\n        \"android.permission.VIBRATE\"\n      ]\n    }\n  }\n}\n```\n- **`BLUETOOTH_CONNECT`** (Android 12+) lets calls route audio to a Bluetooth headset — `\u002Fcalls\u002Freact-native\u002Fsetup` lists it; the calls SDK's own manifest only merges the legacy `BLUETOOTH`.\n- **No `READ_`\u002F`WRITE_EXTERNAL_STORAGE`**, though the `expo-integration` page lists them: they are no-ops on modern Android (WRITE from 11, READ from 13), and the UI Kit's own manifest already merges them for older devices.\n\nAfter changing `app.json`, **rebuild** — a JS reload will not pick up a native permission change.\n\n## Calling on Expo\nCalling adds native WebRTC, so it needs a fresh development build too:\n\n```bash\nnpm install @cometchat\u002Fcalls-sdk-react-native@5\n# 6 REQUIRED peer deps — the calls SDK's declared peerDependencies. Pinned; do NOT float them.\nnpm install @react-native-async-storage\u002Fasync-storage@^2.1.2 react-native-background-timer@^2.4.1 \\\n  react-native-performance@^5.1.2 react-native-svg@^15.12.0 react-native-url-polyfill@2.0.0 \\\n  react-native-webrtc@124.0.7\nnpx expo run:ios\n```\n⚠️ `react-native-url-polyfill` + `react-native-performance` are **bundle-critical** (the UIKit\nmodule-scope `require()`s the calls SDK, so Metro resolves its peers even in a chat-only build — a\nmissing one fails the bundle). Keep `react-native-performance` on **5.x** (a floated `^6` breaks every\nlater `npm install` with ERESOLVE). `@react-native-community\u002Fnetinfo` \u002F `react-native-callstats` are\nNOT declared peers — do not add them.\n\nSimulators cannot capture camera or microphone — verify calls on a real device.\n\n## What is the same as bare RN\nEverything above the native layer: the provider chain, `init → login → render`, every component,\ntheming, navigation. Only install and native config differ. Do not re-derive app code per toolchain.\n\n## Common pitfalls\n1. **Testing in Expo Go** — custom native modules cannot load. Development build, always.\n2. **Editing `ios\u002F` or `android\u002F` directly** — prebuild overwrites it. Use `app.json`.\n3. **Forgetting `punycode`** — Expo-only, and its absence surfaces as an unrelated module error.\n4. **Reloading JS after an `app.json` change** — native config needs a rebuild.\n5. **Expecting calls to work on a simulator** — no camera or mic capture.\n\n## Verify it works\n- The app runs from a development build, not Expo Go.\n- `npm run verify:fences:rn-v5` is green.\n- On device: chat renders, the composer survives the keyboard, gestures respond, and — if calling is\n  installed — the permission prompts appear on first call.\n","> **Ground truth:** `@cometchat\u002Fchat-uikit-react-native@5` + catalog `rn-v5.json`.\n> Docs: `\u002Fui-kit\u002Freact-native\u002Fexpo-integration` · `expo-conversation` · `expo-tab-based-chat`.\n\n## Companion skills (read first)\n- `cometchat-react-native-core` — install, provider chain, init→login→render. Assumed, not repeated here.\n- `cometchat-react-native-bare-patterns` — the bare React Native CLI equivalent. Use that one, not this, for a non-Expo app.\n\n## Use this skill when\n- the project has `app.json`\u002F`app.config.js` with an `expo` key, or `expo` in `package.json`\n- \"add chat to my Expo app\" · \"chat isn't working in Expo Go\"\n\n## Prerequisites & install\n\n### ⚠️ Expo Go does not work — and this is the #1 support issue\nThe UI Kit ships **custom native modules**. Expo Go is a fixed prebuilt binary that cannot load them.\nThere is no workaround, no config flag, and nothing to fix in code. You need a **development build**.\n\nSymptom: the app runs in Expo Go but chat screens crash or render nothing, with a NativeModule error\nthat names `gesture-handler` \u002F `svg` \u002F `video` rather than CometChat — so it reads as unrelated.\n\n```bash\nnpx expo run:ios      # or: npx expo run:android\n```\n\nBoth produce a development build. From then on use that build, not Expo Go.\n\n### Packages\nSame list as bare RN, **plus `punycode`, which is Expo-only**:\n\n```bash\nnpm install @cometchat\u002Fchat-uikit-react-native@5 @cometchat\u002Fchat-sdk-react-native@4\nnpm install @react-native-clipboard\u002Fclipboard \\\n  react-native-svg react-native-video react-native-localize react-native-gesture-handler \\\n  react-native-safe-area-context @react-native-async-storage\u002Fasync-storage@^2.1.2 dayjs punycode\n```\n\n## Native config lives in `app.json` — never in ios\u002F or android\u002F\n\nThis is the whole Expo\u002Fbare divergence: Expo **generates** the native projects, so hand-editing\n`Info.plist` or `AndroidManifest.xml` is pointless — the next prebuild overwrites it. Declare\npermissions in `app.json` and let Expo write them:\n\n```json\n{\n  \"expo\": {\n    \"ios\": {\n      \"infoPlist\": {\n        \"NSCameraUsageDescription\": \"Camera access for video calls\",\n        \"NSMicrophoneUsageDescription\": \"Microphone access for voice\u002Fvideo calls\"\n      }\n    },\n    \"android\": {\n      \"permissions\": [\n        \"android.permission.INTERNET\",\n        \"android.permission.CAMERA\",\n        \"android.permission.MODIFY_AUDIO_SETTINGS\",\n        \"android.permission.RECORD_AUDIO\",\n        \"android.permission.ACCESS_NETWORK_STATE\",\n        \"android.permission.BLUETOOTH_CONNECT\",\n        \"android.permission.VIBRATE\"\n      ]\n    }\n  }\n}\n```\n- **`BLUETOOTH_CONNECT`** (Android 12+) lets calls route audio to a Bluetooth headset — `\u002Fcalls\u002Freact-native\u002Fsetup` lists it; the calls SDK's own manifest only merges the legacy `BLUETOOTH`.\n- **No `READ_`\u002F`WRITE_EXTERNAL_STORAGE`**, though the `expo-integration` page lists them: they are no-ops on modern Android (WRITE from 11, READ from 13), and the UI Kit's own manifest already merges them for older devices.\n\nAfter changing `app.json`, **rebuild** — a JS reload will not pick up a native permission change.\n\n## Calling on Expo\nCalling adds native WebRTC, so it needs a fresh development build too:\n\n```bash\nnpm install @cometchat\u002Fcalls-sdk-react-native@5\n# 6 REQUIRED peer deps — the calls SDK's declared peerDependencies. Pinned; do NOT float them.\nnpm install @react-native-async-storage\u002Fasync-storage@^2.1.2 react-native-background-timer@^2.4.1 \\\n  react-native-performance@^5.1.2 react-native-svg@^15.12.0 react-native-url-polyfill@2.0.0 \\\n  react-native-webrtc@124.0.7\nnpx expo run:ios\n```\n⚠️ `react-native-url-polyfill` + `react-native-performance` are **bundle-critical** (the UIKit\nmodule-scope `require()`s the calls SDK, so Metro resolves its peers even in a chat-only build — a\nmissing one fails the bundle). Keep `react-native-performance` on **5.x** (a floated `^6` breaks every\nlater `npm install` with ERESOLVE). `@react-native-community\u002Fnetinfo` \u002F `react-native-callstats` are\nNOT declared peers — do not add them.\n\nSimulators cannot capture camera or microphone — verify calls on a real device.\n\n## What is the same as bare RN\nEverything above the native layer: the provider chain, `init → login → render`, every component,\ntheming, navigation. Only install and native config differ. Do not re-derive app code per toolchain.\n\n## Common pitfalls\n1. **Testing in Expo Go** — custom native modules cannot load. Development build, always.\n2. **Editing `ios\u002F` or `android\u002F` directly** — prebuild overwrites it. Use `app.json`.\n3. **Forgetting `punycode`** — Expo-only, and its absence surfaces as an unrelated module error.\n4. **Reloading JS after an `app.json` change** — native config needs a rebuild.\n5. **Expecting calls to work on a simulator** — no camera or mic capture.\n\n## Verify it works\n- The app runs from a development build, not Expo Go.\n- `npm run verify:fences:rn-v5` is green.\n- On device: chat renders, the composer survives the keyboard, gestures respond, and — if calling is\n  installed — the permission prompts appear on first call.\n",{"name":5,"license":15,"metadata":50,"description":7,"compatibility":54},{"tags":51,"author":52,"version":53},"chat cometchat react-native expo development-build app-json permissions","CometChat","1.0.0","Expo SDK >=53 (development builds; ships React Native 0.79 — SDK 52 ships RN 0.76, below the pack's RN floor); React Native >=0.77; @cometchat\u002Fchat-uikit-react-native ^5.4.0","main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-react-native-expo-patterns",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":66,"prompt":76,"zipAvailable":77},[67,70,73],{"tool":68,"command":69},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill cometchat-react-native-expo-patterns",{"tool":71,"command":72},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill cometchat-react-native-expo-patterns",{"tool":74,"command":75},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill cometchat-react-native-expo-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-react-native-expo-patterns\u002FSKILL.md",true,[],[80,89,97,105,113,121],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":84,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":88},"01M7DV332YQMGD8WTRJ9DZQXTB","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.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":88},"01M7DV2YGHCZVBEB1AHYB6CGHE","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.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":101,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":88},"01M7DV2TQN1H11ME2SAF9MXN7V","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.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":109,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":88},"01M7DV2NE452NEA8TXATKSNAJH","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.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":117,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":88},"01M7DV2HENRBR2KSCVM064WH0Y","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.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":125,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":88},"01M7DV2CADR5R7RQFFYPNAGR9Y","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.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]