Next Release

.github/actions/install-and-build-sdk/action.yml

@@ -16,11 +16,6 @@ runs:
         cd package/native-package/
         yarn
       shell: bash
-    - name: Install & Build the Expo Package
-      run: |
-        cd package/expo-package/
-        yarn
-      shell: bash
     - name: Install & Build the Sample App
       working-directory: examples/SampleApp
       run: yarn

.github/workflows/changelog-preview.yml

@@ -17,6 +17,8 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
+      - name: Install Linux build tools
+        run: sudo apt-get update && sudo apt-get install -y build-essential
       - uses: actions/checkout@v2
         with:
           ref: develop

.github/workflows/check-pr.yml

@@ -23,6 +23,8 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
+      - name: Install Linux build tools
+        run: sudo apt-get update && sudo apt-get install -y build-essential
       - name: Install && Build - SDK and Sample App
         uses: ./.github/actions/install-and-build-sdk
       - name: Lint

.github/workflows/release.yml

@@ -7,9 +7,9 @@ on:
       - develop
 
 permissions:
-  id-token: write     # for OIDC / npm provenance if you use it
-  actions: write      # if you dispatch other workflows
-  contents: write     # commits / tags / merge-back
+  id-token: write # for OIDC / npm provenance if you use it
+  actions: write # if you dispatch other workflows
+  contents: write # commits / tags / merge-back
 
 jobs:
   publish:
@@ -21,7 +21,7 @@ jobs:
     steps:
       - uses: actions/checkout@v2
         with:
-          fetch-depth: "0"
+          fetch-depth: '0'
 
       - name: Fetch tags
         run: git fetch --depth=1 origin +refs/tags/*:refs/tags/*
@@ -30,7 +30,9 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          registry-url: "https://registry.npmjs.org"
+          registry-url: 'https://registry.npmjs.org'
+      - name: Install Linux build tools
+        run: sudo apt-get update && sudo apt-get install -y build-essential
 
       - name: Prepare git
         run: |

.github/workflows/sample-distribution.yml

@@ -17,7 +17,7 @@ jobs:
     runs-on: [macos-15]
     strategy:
       matrix:
-        node-version: [ 24.x ]
+        node-version: [24.x]
     steps:
       - name: Connect Bot
         uses: webfactory/ssh-agent@v0.7.0
@@ -30,7 +30,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: maxim-lobanov/setup-xcode@v1
         with:
-          xcode-version: '16.4.0' # Update as needed
+          xcode-version: '26.2' # Update as needed
       - uses: ./.github/actions/ruby-cache
       - name: Install && Build - SDK and Sample App
         uses: ./.github/actions/install-and-build-sdk
@@ -51,49 +51,40 @@ jobs:
           bundle exec pod install
       - name: Build and release Testflight QA
         working-directory: examples/SampleApp
-        run: bundle exec fastlane deploy_to_testflight_qa deploy:${{ github.ref == 'refs/heads/develop' }};
+        run: bundle exec fastlane ios deploy_to_testflight_qa deploy:${{ github.ref == 'refs/heads/develop' }};
         env:
           MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}
           MATCH_GIT_BASIC_AUTHORIZATION: ${{ secrets.MATCH_GIT_BASIC_AUTHORIZATION }}
           APPSTORE_API_KEY: ${{ secrets.APPSTORE_API_KEY }}
 
-  build_and_deploy_android_s3:
+  build_and_deploy_android_firebase:
     name: Build SampleApp Android and Deploy-${{ github.ref == 'refs/heads/develop' }}
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [ 24.x ]
+        node-version: [24.x]
     steps:
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
       - uses: actions/checkout@v2
+      - name: Install Linux build tools
+        run: sudo apt-get update && sudo apt-get install -y build-essential
       - uses: actions/setup-java@v3
         with:
           distribution: 'zulu'
           java-version: '17'
           check-latest: true
+      - name: Setup Android SDK
+        uses: amyu/setup-android@v5
+
+      - uses: ./.github/actions/ruby-cache
       - name: Install && Build - SDK and Sample App
         uses: ./.github/actions/install-and-build-sdk
-      - name: Build
+      - name: Build and deploy Android Firebase
         working-directory: examples/SampleApp
-        run: |
-          mkdir android/app/src/main/assets
-          mkdir tmp
-          yarn react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest tmp
-          cd android
-          rm -rf $HOME/.gradle/caches/ && ./gradlew assembleRelease
-      - name: Configure AWS credentials
-        uses: aws-actions/configure-aws-credentials@v1
-        if: ${{ github.ref == 'refs/heads/develop' }}
-        with:
-          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
-          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-          aws-region: us-east-1
-      - name: Upload APK
-        if: ${{ github.ref == 'refs/heads/develop' }}
-        # https://getstream.io/downloads/rn-sample-app.apk
-        run: |
-          cp examples/SampleApp/android/app/build/outputs/apk/release/app-release.apk rn-sample-app.apk
-          aws s3 cp rn-sample-app.apk s3://${{ secrets.AWS_S3_BUCKET }} --sse AES256
+        run: bundle exec fastlane android firebase_build_and_upload deploy:${{ github.ref == 'refs/heads/develop' }};
+        env:
+          ANDROID_FIREBASE_APP_ID: ${{ secrets.ANDROID_FIREBASE_APP_ID }}
+          FIREBASE_CREDENTIALS_JSON: ${{ secrets.FIREBASE_CREDENTIALS_JSON }}

.gitignore

@@ -23,3 +23,4 @@ index.android.bundle
 *.app
 *.DSYM.zip
 **/metrics/
+package/shared-native/.sync-state/

CLAUDE.md

@@ -0,0 +1,156 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Repository Overview
+
+Stream Chat React Native SDK monorepo. The main SDK code lives in `package/` (published as `stream-chat-react-native-core`). Built on top of the `stream-chat` JS client library.
+
+## Common Commands
+
+All commands below run from the repo root unless noted otherwise.
+
+### Build
+
+```bash
+yarn build                    # Build all packages (runs in package/)
+cd package && yarn build      # Build SDK directly
+```
+
+### Lint & Format
+
+```bash
+cd package && yarn lint       # Check prettier + eslint + translation validation (max-warnings 0)
+cd package && yarn lint-fix   # Auto-fix lint and formatting issues
+```
+
+### Test
+
+```bash
+cd package && yarn test:unit              # Run all unit tests (sets TZ=UTC)
+cd package && yarn test:coverage          # Run with coverage report
+cd package && TZ=UTC npx jest path/to/test.test.tsx  # Run a single test file
+```
+
+Tests use Jest with `react-native` preset and `@testing-library/react-native`. Test files live alongside source at `src/**/__tests__/*.test.ts(x)`. Mock builders are in `src/mock-builders/`.
+
+To run a single test, you can also temporarily add the file path to the `testRegex` array in `package/jest.config.js`.
+
+### Install
+
+```bash
+yarn install --frozen-lockfile         # Root dependencies
+cd package && yarn install-all         # SDK + native-package + expo-package
+```
+
+### Sample App
+
+```bash
+cd examples/SampleApp && yarn install
+cd examples/SampleApp && yarn start    # Metro bundler
+cd examples/SampleApp && yarn ios      # Run iOS
+cd examples/SampleApp && yarn android  # Run Android
+```
+
+## Architecture
+
+### Package Structure
+
+- `package/` — Main SDK (`stream-chat-react-native-core`)
+- `package/native-package/` — React Native native module wrappers
+- `package/expo-package/` — Expo-compatible wrapper
+- `examples/SampleApp/` — Full sample app with navigation
+- `release/` — Semantic release scripts
+
+### SDK Source (`package/src/`)
+
+**Component hierarchy**: `<Chat>` → `<Channel>` → `<MessageList>` / `<MessageInput>` / `<Thread>`
+
+- `components/` — UI components (~28 major ones: ChannelList, MessageList, MessageInput, Thread, Poll, ImageGallery, etc.)
+- `contexts/` — React Context providers (~33 contexts). The primary way components receive state and callbacks. Key contexts: `ChatContext`, `ChannelContext`, `MessagesContext`, `ThemeContext`, `TranslationContext`
+- `hooks/` — Custom hooks (~27+). Access contexts via `useChannelContext()`, `useMessageContext()`, etc.
+- `state-store/` — Client-side state stores using `useSyncExternalStore` with selector pattern (audio player, image gallery, message overlay, etc.)
+- `store/` — Offline SQLite persistence layer. `OfflineDB` class with mappers for channels, messages, reactions, members, drafts, reminders. Schema in `store/schema.ts`
+- `theme/` — Deep theming system (colors, typography, spacing, per-component overrides) via `ThemeContext`
+- `i18n/` — Internationalization with i18next (14 languages). `Streami18n` wrapper class
+- `middlewares/` — Command UI middlewares (attachments, emoji)
+- `icons/` — SVG icon components
+
+### Key Patterns
+
+**Component override pattern**: Nearly every UI element is replaceable via props. Parent components (e.g., `Channel`) accept 50+ `React.ComponentType` props for sub-components (`Message`, `MessageContent`, `DateHeader`, `TypingIndicator`, etc.). These props are forwarded into Context providers so deeply nested children can access them without prop drilling.
+
+**Context three-layer pattern**: Each context follows the same structure:
+
+1. `createContext()` with a sentinel default value (`DEFAULT_BASE_CONTEXT_VALUE`)
+2. A `<XProvider>` wrapper component
+3. A `useXContext()` hook that throws if used outside the provider (suppressed in test env via `isTestEnvironment()`)
+
+Context values are assembled in dedicated `useCreateXContext()` hooks (e.g., `useCreateChannelContext`) that carefully memoize with selective dependencies to avoid unnecessary re-renders.
+
+**Native module abstraction**: `native.ts` defines TypeScript interfaces for all platform-specific capabilities (image picking, compression, haptics, audio/video, clipboard). Implementations are injected at runtime via `registerNativeHandlers()` — `stream-chat-expo` provides Expo implementations, `stream-chat-react-native` provides bare RN ones. Calling an unregistered handler throws with a message to import the right package.
+
+**State stores**: `useSyncExternalStore`-based stores in `state-store/` with `useStateStore(store, selector)` for fine-grained subscriptions outside the context system.
+
+**Memoization**: Components use `React.memo()` with custom `areEqual` comparators (not HOCs) to prevent re-renders.
+
+**Offline-first**: SQLite-backed persistence with sync status tracking and pending task management.
+
+**Builder-bob builds**: Outputs CommonJS (`lib/commonjs`), ESM (`lib/module`), and TypeScript declarations (`lib/typescript`).
+
+### Testing Patterns
+
+Tests use `renderHook()` and `render()` from `@testing-library/react-native`. Components/hooks must be wrapped in the required provider stack (e.g., `Chat` → `Channel` → feature provider).
+
+**Mock builders** (`src/mock-builders/`):
+
+- `api/initiateClientWithChannels.js` — creates a test client + channels in one call
+- `generator/` — factories: `generateMessage()`, `generateChannel()`, `generateUser()`, `generateMember()`, `generateStaticMessage(seed)` (deterministic via UUID v5)
+- `attachments.js` — `generateImageAttachment()`, `generateFileAttachment()`, `generateAudioAttachment()`
+
+Reanimated and native modules are mocked via Proxy patterns in test setup files.
+
+### Theme System
+
+Themes follow a three-tier token architecture: **Primitives** (raw colors) → **Semantics** (e.g., `colors.error.primary`) → **Components** (per-component overrides). Token references use `$key` string syntax (e.g., `"$blue500"`) and are resolved via topological sort in `theme/topologicalResolution.ts`, so declaration order doesn't matter.
+
+Platform-specific tokens are **generated** files in `src/theme/generated/{light,dark}/StreamTokens.{ios,android,web}.ts` — regenerate via `sync-theme.sh` if design tokens change; don't hand-edit.
+
+Custom themes are passed as `style` prop to `<Chat>`. `mergeThemes()` deep-merges custom style over base theme (deep-cloned via `JSON.parse(JSON.stringify())`). Light/dark mode is auto-detected via `useColorScheme()`.
+
+### Native / Expo Package Relationship
+
+`native-package/` and `expo-package/` are thin wrappers around `stream-chat-react-native-core`. They:
+
+1. Call `registerNativeHandlers()` with platform-specific implementations (native modules vs Expo APIs)
+2. Export optional dependency wrappers (`Audio`, `Video`, `FlatList`) from `src/optionalDependencies/`
+3. Re-export everything from core: `export * from 'stream-chat-react-native-core'`
+
+Platform branching uses runtime `Platform.select()` / `Platform.OS` checks — there are no `.ios.ts` / `.android.ts` source file splits.
+
+### Chat Component (Root Provider)
+
+`<Chat client={client}>` is the entry point. It:
+
+- Sets SDK metadata on the `stream-chat` client (identifier, device info)
+- Disables the JS client's `recoverStateOnReconnect` (the SDK handles recovery itself)
+- Registers subscriptions for threads, polls, and reminders (cleaned up on unmount)
+- Initializes `OfflineDB` if `enableOfflineSupport` is true
+- Wraps children in: `ChatProvider` → `TranslationProvider` → `ThemeProvider` → `ChannelsStateProvider`
+
+### Offline DB
+
+SQLite schema is in `store/schema.ts`. DB versioning uses `PRAGMA user_version` — a version mismatch triggers full DB reinit (no incremental migrations). Current version is tracked in `SqliteClient.dbVersion`.
+
+### Translations
+
+Translation JSON files live in `src/i18n/`. `validate-translations` (run as part of `yarn lint`) checks that no translation key has an empty string value. When adding/updating translations, run `yarn build-translations` (i18next-cli sync) to keep files in sync.
+
+## Conventions
+
+- **Conventional commits** enforced by commitlint: `feat:`, `fix:`, `docs:`, `refactor:`, etc.
+- **ESLint 9 flat config** at `package/eslint.config.mjs`, strict (max-warnings 0)
+- **Prettier**: single quotes, trailing commas, 100 char width (see `.prettierrc`)
+- **TypeScript strict mode** with platform-specific module suffixes (`.ios`, `.android`, `.web`)
+- Git branches: PRs target `develop`, `main` is production releases only
+- **Shared native sync**: Run `yarn shared-native:sync` from `package/` after modifying shared native code to copy to native-package and expo-package

README.md

@@ -10,7 +10,7 @@
 [![NPM](https://img.shields.io/npm/v/stream-chat-react-native.svg)](https://www.npmjs.com/package/stream-chat-react-native)
 [![Build Status](https://github.com/GetStream/stream-chat-react-native/actions/workflows/release.yml/badge.svg)](https://github.com/GetStream/stream-chat-react-native/actions)
 [![Component Reference](https://img.shields.io/badge/docs-component%20reference-blue.svg)](https://getstream.io/chat/docs/sdk/reactnative)
-![JS Bundle Size](https://img.shields.io/badge/js_bundle_size-302%20KB-blue)
+![JS Bundle Size](https://img.shields.io/badge/js_bundle_size-304%20KB-blue)
 
 <img align="right" src="https://getstream.imgix.net/images/ios-chat-tutorial/iphone_chat_art@3x.png?auto=format,enhance" width="50%" />
 

examples/ExpoMessaging/app.json

@@ -18,7 +18,9 @@
     "experiments": {
       "reactCompiler": true
     },
-    "assetBundlePatterns": ["**/*"],
+    "assetBundlePatterns": [
+      "**/*"
+    ],
     "ios": {
       "supportsTablet": true,
       "usesIcloudStorage": true,
@@ -86,16 +88,21 @@
         "expo-build-properties",
         {
           "android": {
-            "extraMavenRepos": ["$rootDir/../../../node_modules/@notifee/react-native/android/libs"]
+            "extraMavenRepos": [
+              "$rootDir/../../../node_modules/@notifee/react-native/android/libs"
+            ]
           },
           "ios": {
             "useFrameworks": "static",
-            "forceStaticLinking": ["RNFBApp", "RNFBMessaging"]
+            "forceStaticLinking": [
+              "RNFBApp",
+              "RNFBMessaging"
+            ]
           }
         }
       ],
-      "./plugins/keyboardInsetMainActivityListener.js",
-      "./plugins/opSqliteSwiftPlugin.js"
+      "./plugins/opSqliteSwiftPlugin.js",
+      "expo-sharing"
     ]
   }
 }