React Native installation

Compatibility

The SDK supports the full surface below: every target can open a chat, and none of them crash.

Capability	Bare RN (old + New Arch)	Expo dev build / EAS	Expo Go
Device key	✅ Secure Enclave / Keystore	✅ (via config plugin)	⚠️ software P-256 fallback
Secure storage	✅ `react-native-keychain`	✅ `expo-secure-store`	✅ `expo-secure-store`
Realtime (Centrifugo + SSE)	✅	✅	✅
Push	✅ (host Firebase)	✅	⛔ remote push N/A in Go
Attachments	✅	✅	✅ (Expo pickers)
Prebuilt UI	✅	✅	✅

The hardware key needs a dev build (Expo Go can’t load native modules); the SDK transparently falls back to a software ECDSA P-256 key, so you can evaluate the whole flow in Expo Go and ship hardware-backed with no code change.

Core install

npm install @clariodesk/react-native
npm install react-native-get-random-values   # secure RNG (required)

Import react-native-get-random-values once, at the very top of index.js, before any other import. The crypto layer depends on it being registered first.

Peer dependencies

Install only what your stack and features need:

# secure storage (required, pick one)
npx expo install expo-secure-store        # Expo
npm install react-native-keychain         # bare RN

# attachments (optional, only if you attach files)
npx expo install expo-image-picker expo-document-picker expo-image-manipulator   # Expo
npm install react-native-image-picker @react-native-documents/picker             # bare RN

# connectivity-reactive reconnect (optional)
npm install @react-native-community/netinfo

Expo

Add the config plugin, then make a dev build (or run in Expo Go for the software tier):

{ "expo": { "plugins": ["@clariodesk/react-native"] } }
// parameterize: ["@clariodesk/react-native", { "enableCamera": false, "enablePush": true }]

npx expo prebuild && npx expo run:ios

The config plugin wires the native module and adds the iOS photo/camera/mic usage strings needed for attachments.

Bare React Native

Autolinking handles the native module. Run the Expo modules installer once (the device-key module is authored with the Expo Modules API), then install pods:

npx install-expo-modules@latest
cd ios && pod install

Push (separate package)

Push lives in @clariodesk/react-native-push so Firebase never autolinks into a headless host. See the push guide.

Next: lifecycle

Wire login, launch, logout, and user-switch.

​Compatibility

​Core install

​Peer dependencies

​Expo

​Bare React Native

​Push (separate package)

Next: lifecycle

Compatibility

Core install

Peer dependencies

Expo

Bare React Native

Push (separate package)