@fishjam-cloud/react-native-client

React Native client library for Fishjam.

Installation

npm install @fishjam-cloud/react-native-client
# or
yarn add @fishjam-cloud/react-native-client

Local Development with WebRTC Fork

This package depends on @fishjam-cloud/react-native-webrtc, a fork of react-native-webrtc. The fork lives in its own GitHub repo and is included in this monorepo as a git submodule at packages/react-native-webrtc/, wired up as a yarn workspace. No manual linking is required.

Setup

Clone the repository with submodules:

git clone --recurse-submodules https://github.com/fishjam-cloud/web-client-sdk.git

If you already cloned without --recurse-submodules, initialize the submodules from inside the repo:

git submodule update --init --recursive

Then install dependencies from the repo root:

yarn install

Yarn resolves @fishjam-cloud/react-native-webrtc to the workspace at packages/react-native-webrtc/, and React Native autolinking picks up the native iOS and Android code automatically through the symlinked package.

Development Workflow

| Change Type | What to Do | | ------------------------------------- | ----------------------------------------------------- | | JS/TS changes in the fork | Save → Metro hot reloads automatically | | Native code changes (iOS/Android) | Save → Rebuild the app (yarn ios or yarn android) |

No pod install or yarn install is needed after native code changes — just rebuild the app.

Updating the Submodule

The submodule tracks the fork's master branch but is pinned to a specific commit. To update to the latest upstream:

git submodule update --remote packages/react-native-webrtc
git add packages/react-native-webrtc
git commit -m "Bump react-native-webrtc submodule"

To check out a specific tag or commit:

git -C packages/react-native-webrtc fetch
git -C packages/react-native-webrtc checkout <tag-or-sha>
git add packages/react-native-webrtc
git commit -m "Pin react-native-webrtc to <tag-or-sha>"

When bumping the submodule across a version boundary, also update peerDependencies.@fishjam-cloud/react-native-webrtc in this package's package.json so external consumers see the correct range.

Contributing Changes to the Fork

Changes inside packages/react-native-webrtc/ belong to the fork's own repo, not this one. To push them upstream:

cd packages/react-native-webrtc
git checkout -b your-feature-branch
# commit your changes
git push origin your-feature-branch
# open a PR against fishjam-cloud/fishjam-react-native-webrtc

Once the upstream PR is merged, bump the submodule sha here (see "Updating the Submodule" above).