@edge-base/react-native 0.1.4 → 0.2.0

package/README.md

@@ -1,3 +1,9 @@
+<p align="center">
+  <a href="https://github.com/edge-base/edgebase">
+    <img src="https://raw.githubusercontent.com/edge-base/edgebase/main/docs/static/img/logo-icon.svg" alt="EdgeBase Logo" width="72" />
+  </a>
+</p>
+
 <h1 align="center">@edge-base/react-native</h1>
 
 <p align="center">
@@ -37,7 +43,9 @@ It keeps the familiar browser SDK shape while adding the pieces mobile apps need
 
 If you are building a browser-only app, use [`@edge-base/web`](https://www.npmjs.com/package/@edge-base/web) instead.
 
-EdgeBase is an open-source edge-native BaaS that runs on Edge, Docker, and Node.js. If you want the full platform, CLI, docs, and the rest of the public SDKs, see the main repository: [edge-base/edgebase](https://github.com/edge-base/edgebase).
+EdgeBase is the open-source edge-native BaaS that runs on Edge, Docker, and Node.js.
+
+This package is one part of the wider EdgeBase platform. For the full platform, CLI, Admin Dashboard, server runtime, docs, and all public SDKs, see the main repository: [edge-base/edgebase](https://github.com/edge-base/edgebase).
 
 > Beta: the package is already usable, but some APIs may still evolve before general availability.
 
@@ -217,6 +225,57 @@ When you pass `appState` to `createClient()`, the SDK automatically coordinates
 - background/inactive: disconnect realtime transports to reduce battery and network use
 - foreground: refresh auth state and reconnect realtime transports
 
+## Room Media Transports
+
+React Native now exposes the same top-level room media transport entrypoint as the web SDK:
+
+```ts
+const room = client.room('calls', 'demo');
+await room.join();
+
+const transport = room.media.transport({
+  provider: 'cloudflare_realtimekit',
+});
+
+await transport.connect({
+  name: 'June',
+  customParticipantId: 'mobile-june',
+});
+
+await transport.enableAudio();
+await transport.enableVideo();
+```
+
+Available providers:
+
+- `cloudflare_realtimekit`
+  Uses Cloudflare RealtimeKit for managed media sessions
+- `p2p`
+  Uses direct peer-to-peer media with signaling through `room.signals`
+
+Install the matching optional peer dependencies for the transport you use:
+
+```bash
+npm install @cloudflare/realtimekit-react-native
+npm install @cloudflare/react-native-webrtc
+```
+
+Practical integration notes from the current host-app smoke matrix:
+
+- `cloudflare_realtimekit` currently expects React Native `0.77+`
+- iOS needs the usual `cd ios && pod install`
+- Android apps using `@cloudflare/realtimekit-react-native` need a `blob_provider_authority` string resource
+- current host-app smoke builds succeeded on both iOS simulator and Android debug
+
+```xml
+<string name="blob_provider_authority">${applicationId}.blobs</string>
+```
+
+For setup details and provider tradeoffs, see the room media docs:
+
+- [Room Media Overview](https://edgebase.fun/docs/room/media)
+- [Room Media Setup](https://edgebase.fun/docs/room/media-setup)
+
 ## Platform Differences vs `@edge-base/web`
 
 | Feature | Web | React Native |