stream-react-native

name	stream-react-native
description	Create, build, and integrate Stream Chat React Native apps in React Native Community CLI and Expo. Use for new RN/Expo Chat apps from scratch, existing app integration, Stream Chat RN, stream-chat-react-native, stream-chat-expo, migration/setup, channel list, message list, MessageComposer, attachment picker, image/file attachments, media picker, camera upload, audio messages, threads, thread list, React Navigation, Expo Router, theming, offline support, push notifications, and Chat customization. Chat only in v1; not for Stream Video, Feeds, or Moderation UI.
license	See LICENSE in repository root
compatibility	Supports new or existing React Native CLI and Expo apps that can run Stream Chat RN with React Native New Architecture. The `stream` CLI is the default credentials and requested demo-data path; pasted API key and token are accepted as fallback.
metadata	{"author":"GetStream"}
allowed-tools	Read, Write, Edit, Glob, Grep, WebFetch(domain:getstream.io), Bash(ls *), Bash(find . *), Bash(grep *), Bash(cat package.json), Bash(cat app.json), Bash(cat app.config.js), Bash(cat app.config.ts), Bash(cat babel.config.js), Bash(cat metro.config.js), Bash(command -v stream), Bash(stream token *), Bash(stream config *), Bash(stream --safe api *), Bash(stream api *), Bash(npm view *), Bash(npm install *), Bash(yarn add *), Bash(pnpm add *), Bash(curl -Ls https://getstream.io/chat/docs/sdk/react-native/llms.txt), Bash(curl -Ls https://getstream.io/chat/docs/react-native/llms.txt), Bash(npx create-expo-app@latest *), Bash(npx create-expo-app *), Bash(npx @react-native-community/cli@latest init *), Bash(npx expo install *), Bash(npx expo prebuild *), Bash(npx expo start *), Bash(npm run *), Bash(yarn *), Bash(pnpm *), Bash(npx pod-install *), Bash(cd ios && pod install)

Stream React Native - skill router + execution flow

Rules: Read RULES.md once per session. Every non-negotiable React Native Chat rule is stated there.

This file is the single entrypoint: intent classification, project detection, and module pointers for Stream Chat React Native work.

---

Step 0: Intent classifier (mandatory first - never skip)

Before any tool call, decide the track from the user's input alone. Do not probe the filesystem first.

Signals -> track

Signal in user input	Track
"Build/create/scaffold a new React Native app", "create an Expo app", "new Stream Chat RN app", empty directory + React Native/Expo Chat	A - New app
"Add/integrate Stream Chat into this app", "wire Chat RN", "set up stream-chat-expo", "change/customize this Chat UI"	B - Existing app
React Native, Expo, Expo Router, stream-chat-react-native, stream-chat-expo, Stream Chat RN, Chat React Native, migration	C - Reference lookup if the user only asks how/docs; otherwise B - Existing app
Words "docs" or "documentation" around Stream Chat React Native / Expo work	C - Reference lookup
"How do I {X} in React Native/Expo?", "What does {SDK component/hook/prop} do?"	C - Reference lookup
"Install Stream packages", "set up Chat RN", "wire auth/token flow" with no broader feature request	D - Bootstrap / setup
Video, Feeds, Moderation review UI, or non-Chat Stream RN product	Reject bundled scope and route to live docs only if the user wants docs
Bare /stream-react-native with no args	List the tracks briefly and wait

Disambiguation flow

If the request is ambiguous between wiring code and reference lookup, ask one short question and wait:

Do you want me to wire this into the project, or just map the React Native SDK pattern and files?