diff --git a/.gitmodules b/.gitmodules
index 5056c22..6f03827 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -2,6 +2,9 @@
 	path = packages/web-client-sdk
 	url = https://github.com/fishjam-cloud/web-client-sdk.git
 	branch = mobile-sdk-2-0
+[submodule "packages/mobile-client-sdk"]
+	path = packages/mobile-client-sdk
+	url = https://github.com/fishjam-cloud/mobile-client-sdk.git
 [submodule "packages/js-server-sdk"]
 	path = packages/js-server-sdk
 	url = https://github.com/fishjam-cloud/js-server-sdk.git
diff --git a/docs/how-to/client/migration-guide.mdx b/docs/how-to/client/migration-guide.mdx
new file mode 100644
index 0000000..fd25557
--- /dev/null
+++ b/docs/how-to/client/migration-guide.mdx
@@ -0,0 +1,538 @@
+---
+sidebar_position: 0
+sidebar_label: "Migration Guide"
+---
+
+# Migration Guide: From @fishjam-cloud/react-native-client to @fishjam-cloud/mobile-client
+
+This guide will help you migrate your React Native application from `@fishjam-cloud/react-native-client` to `@fishjam-cloud/mobile-client`.
+
+## Overview
+
+The new `@fishjam-cloud/mobile-client` package provides a more consistent API across web and mobile platforms, improved TypeScript support, and better integration with React's context system.
+
+## Package Installation
+
+### Before
+
+```bash
+npm install @fishjam-cloud/react-native-client
+```
+
+### After
+
+```bash
+npm install @fishjam-cloud/mobile-client
+```
+
+Remember to update all your imports:
+
+**From:**
+```tsx
+import { useCamera } from "@fishjam-cloud/react-native-client";
+
+```
+
+**To:**
+```tsx
+import { useCamera } from "@fishjam-cloud/mobile-client";
+```
+
+## Required Android Permissions
+
+Add the following WebRTC permissions to your Android configuration in `app.json`:
+
+```json
+{
+  "expo": {
+    "android": {
+      "permissions": [
+        "android.permission.CAMERA",
+        "android.permission.RECORD_AUDIO",
+        "android.permission.MODIFY_AUDIO_SETTINGS",
+        "android.permission.ACCESS_NETWORK_STATE",
+        "android.permission.ACCESS_WIFI_STATE"
+      ]
+    }
+  }
+}
+```
+## FishjamProvider Setup
+
+The new package requires wrapping your app with `FishjamProvider` to provide the Fishjam ID context.
+
+### Before
+
+```tsx
+import React from "react";
+// ---cut---
+import { useConnection } from "@fishjam-cloud/react-native-client";
+
+const { joinRoom } = useConnection();
+// fishjamId was passed directly to joinRoom
+await joinRoom({ fishjamId: "your-fishjam-id", peerToken: "..." });
+
+```
+
+### After
+
+```tsx
+import React from "react";
+import { Text } from "react-native";
+// ---cut---
+import { FishjamProvider } from "@fishjam-cloud/mobile-client"; // [!code highlight]
+
+// Wrap your app with FishjamProvider
+export default function App() {
+  return (
+    <FishjamProvider fishjamId="YOUR_FISHJAM_ID"> // [!code highlight]
+      <YourApp />
+    </FishjamProvider> // [!code highlight]
+  );
+}
+
+const YourApp = () => {return (<><Text>Your app content</Text></>);};
+
+```
+
+The `fishjamId` is now provided through the context, so you no longer need to pass it to `joinRoom` or `useSandbox`.
+
+## Device Initialization
+
+### Before
+
+```tsx
+import { useCamera } from "@fishjam-cloud/react-native-client";
+
+const { prepareCamera } = useCamera();
+
+await prepareCamera({ cameraEnabled: true });
+
+```
+
+### After
+
+```tsx
+import { useInitializeDevices } from "@fishjam-cloud/mobile-client";
+
+const { initializeDevices } = useInitializeDevices();
+
+// Initialize devices when you first want to stream
+await initializeDevices({ enableAudio: false }); // or initializeDevices() for both
+
+```
+
+:::important
+On mobile, you should use `initializeDevices()` when you first want to stream. This gives your app access to all available devices and automatically requests camera and microphone permissions. After initialization, you can use `startCamera`/`stopCamera` or `startMicrophone`/`stopMicrophone` to manage device state.
+:::
+
+## Video Rendering and Accessing Peer Tracks
+Key changes:
+
+- `VideoRendererView` → `RTCView`
+- `trackId` prop → `streamURL` prop
+- Use `stream.toURL()` to get the URL from a MediaStream
+- Access peer video via `peer.cameraTrack.stream` instead of `peer.track`
+
+### Before
+
+```tsx
+import React from "react";
+import { View } from "react-native";
+// ---cut---
+import { usePeers, VideoRendererView } from "@fishjam-cloud/react-native-client";
+
+const { remotePeers, localPeer } = usePeers();
+
+const videoTracks = remotePeers.flatMap(
+    (peer) =>
+      peer.tracks.filter((track) => track.type === "Video" && track.isActive),
+  );
+const localTrack = localPeer?.tracks.find((t) => t.type === "Video");
+
+<View>
+    {localTrack && (
+    <VideoRendererView
+        key={localTrack.id}
+        trackId={localTrack.id}
+        videoLayout="FIT"
+    />
+    )}
+    {videoTracks.map((track) => (
+    <VideoRendererView
+        key={track.id}
+        trackId={track.id}
+        videoLayout="FIT"
+    />
+    ))}
+</View>
+```
+
+### After
+
+```tsx
+import React from "react";
+// ---cut---
+import { usePeers, RTCView } from "@fishjam-cloud/mobile-client";
+
+//TODO: FCE-2487 remove it when MediaStream will be updated
+interface MediaStreamWithURL extends MediaStream {
+  toURL(): string;
+}
+
+function VideoPlayer({ stream }: { stream: MediaStream | null | undefined }) {
+  const streamURL = stream ? (stream as MediaStreamWithURL).toURL() : null;
+
+  if (!streamURL) return null;
+
+  return (
+    <RTCView
+      streamURL={streamURL}
+      style={{ width: 300, height: 200 }}
+      objectFit="cover"
+    />
+  );
+}
+
+const { localPeer, remotePeers } = usePeers();
+{localPeer?.cameraTrack?.stream && ( 
+    <VideoPlayer stream={localPeer.cameraTrack.stream} />
+)}
+
+{remotePeers.map((peer) => (
+    <>
+    {peer.cameraTrack?.stream && (
+        <VideoPlayer stream={peer.cameraTrack.stream} />
+    )}
+    </>
+))}
+```
+
+Key changes:
+- `VideoRendererView` → `RTCView`
+- `trackId` prop → `streamURL` prop
+- Use `stream.toURL()` to get the URL from a MediaStream
+- `peer.tracks` array → `peer.cameraTrack` and `peer.microphoneTrack` properties
+- `track.isActive` removed (check if stream exists instead)
+- `track.type` removed (use specific track properties)
+
+## Connection API
+
+### Before
+
+```tsx
+import { useConnection, useSandbox } from "@fishjam-cloud/react-native-client";
+
+const { joinRoom } = useConnection();
+const { getSandboxPeerToken } = useSandbox({ fishjamId: "your-id" });
+
+const peerToken = await getSandboxPeerToken("roomName", "peerName");
+await joinRoom({ fishjamId: "your-id", peerToken });
+
+```
+### After
+
+```tsx
+import { useConnection, useSandbox } from "@fishjam-cloud/mobile-client";
+
+const { joinRoom } = useConnection();
+// fishjamId is now provided through FishjamProvider
+const { getSandboxPeerToken } = useSandbox();
+
+const peerToken = await getSandboxPeerToken("roomName", "peerName");
+await joinRoom({ peerToken }); // fishjamId passed through FishjamProvider
+
+```
+
+## Device Management
+
+### Camera Device Selection
+
+### Before
+
+```tsx
+import { useCamera } from "@fishjam-cloud/react-native-client";
+
+const { cameras, switchCamera, currentCamera } = useCamera();
+
+// find first camera facing opposite direction than current camera
+const otherCamera = cameras.find(
+    (camera) => camera.facingDirection !== currentCamera?.facingDirection,
+);
+if (otherCamera) {
+    switchCamera(otherCamera.id);
+}
+
+```
+
+### After
+
+```tsx
+import { useCamera } from "@fishjam-cloud/mobile-client";
+const { cameraDevices, selectCamera } = useCamera();
+
+// Select camera by deviceId
+const nextCamera = cameraDevices[0];
+if (nextCamera) {
+  selectCamera(nextCamera.deviceId);
+}
+
+```
+
+Key changes:
+
+- `cameras` → `cameraDevices`
+- `switchCamera` → `selectCamera` (takes `deviceId` instead of direction)
+- `facingDirection` property removed
+
+### Camera Control
+
+### Before
+
+```tsx
+import React from "react";
+import { Button } from "react-native";
+// ---cut---
+import { useCamera } from "@fishjam-cloud/react-native-client";
+const { isCameraOn, toggleCamera } = useCamera();
+
+<Button
+    onPress={toggleCamera}
+    title={isCameraOn ? "Disable camera" : "Enable camera"}
+/>
+
+```
+
+### After
+
+```tsx
+import { useCamera } from "@fishjam-cloud/mobile-client";
+const { startCamera, stopCamera, toggleCamera } = useCamera();
+
+// Start camera
+await startCamera();
+
+// Stop camera
+await stopCamera();
+
+// Toggle camera
+toggleCamera();
+
+```
+
+## Screen Sharing
+
+### Before
+
+```tsx
+import React, { useCallback } from "react";
+import { Button } from "react-native";
+// ---cut---
+import { useScreenShare } from "@fishjam-cloud/react-native-client";
+
+const { toggleScreenShare, isScreenShareOn } = useScreenShare();
+const onPressToggle = useCallback(
+    () => toggleScreenShare(),
+    [toggleScreenShare],
+  );
+
+<Button
+  onPress={onPressToggle}
+  title={isScreenShareOn ? "Disable" : "Enable"}
+/>
+
+```
+
+### After
+
+```tsx
+import React, { useCallback } from "react";
+import { Button } from "react-native";
+// ---cut---
+import { useScreenShare } from "@fishjam-cloud/mobile-client";
+
+const { startStreaming, stopStreaming, stream } = useScreenShare();
+
+const onPressToggle = () => {
+  if (stream) {
+    stopStreaming();
+  } else {
+    startStreaming();
+  }
+};
+
+<Button
+  onPress={onPressToggle}
+  title={stream ? "Disable" : "Enable"}
+/>
+
+```
+
+Key changes:
+
+- `toggleScreenShare()` → `startStreaming()` / `stopStreaming()`
+- `isScreenShareOn` → check if `stream` exists
+
+## Picture in Picture
+
+### Before
+
+```tsx
+import React from "react";
+import { View } from "react-native";
+// ---cut---
+import { PipContainerView } from "@fishjam-cloud/react-native-client";
+export function VideoCallScreen() {
+  return (
+    <PipContainerView>
+      <View>{/* Your video call UI */}</View>
+    </PipContainerView>
+  );
+}
+
+```
+
+### After
+
+```tsx
+import React, { useRef } from "react";
+import { Button } from "react-native";
+// ---cut---
+import { RTCPIPView, startPIP, stopPIP, usePeers } from "@fishjam-cloud/mobile-client";
+
+//TODO: FCE-2487 remove it when MediaStream will be updated
+interface MediaStreamWithURL extends MediaStream {
+  toURL(): string;
+}
+
+const pipViewRef = useRef<React.ElementRef<typeof RTCPIPView>>(null);
+const { localPeer } = usePeers();
+const stream = localPeer?.cameraTrack?.stream
+const streamURL = stream ? (stream as MediaStreamWithURL).toURL() : undefined;
+
+<>
+    <RTCPIPView
+    ref={pipViewRef}
+    streamURL={streamURL}
+    style={{ width: 300, height: 200 }}
+    pip={{
+        startAutomatically: true,
+        stopAutomatically: true,
+        enabled: true,
+    }}
+    />
+
+    // Manual control
+
+    <Button title="Start PiP" onPress={() => startPIP(pipViewRef as any)} />
+    <Button title="Stop PiP" onPress={() => stopPIP(pipViewRef as any)} />
+</>
+
+```
+
+Key changes:
+
+- `PipContainerView` → `RTCPIPView`
+- `trackId` prop → `streamURL` prop
+- Requires a ref for manual `startPIP`/`stopPIP` control
+- Added `pip` prop for configuration
+
+## Livestreaming Imports
+
+### Before
+
+```tsx
+import {
+  useLivestreamStreamer,
+  useLivestreamViewer,
+} from "@fishjam-cloud/react-native-client/livestream";
+
+```
+
+### After
+
+```tsx
+import {
+  useLivestreamStreamer,
+  useLivestreamViewer,
+} from "@fishjam-cloud/mobile-client";
+
+```
+
+The livestreaming hooks are now exported from the main package instead of a separate `/livestream` subpath.
+
+## Removed Hooks and APIs
+
+The following hooks and APIs have been removed and are no longer available:
+
+### Permission Hooks
+
+### Before
+
+```tsx
+import {
+  useCameraPermissions,
+  useMicrophonePermissions,
+} from "@fishjam-cloud/react-native-client";
+
+const [cameraPermission, requestCameraPermission] = useCameraPermissions();
+const [micPermission, requestMicPermission] = useMicrophonePermissions();
+
+```
+
+### After
+Permissions are now handled automatically by the SDK. When you call initializeDevices(), the SDK will automatically request camera and microphone permissions if they haven't been granted yet.
+
+### CallKit Hooks
+
+### Before
+
+```tsx
+import {
+  useCallKit,
+  useCallKitService,
+  useCallKitEvent,
+} from "@fishjam-cloud/react-native-client";
+
+// Manual CallKit control
+const { startCallKitSession, endCallKitSession } = useCallKit();
+
+// Automatic CallKit service
+useCallKitService({
+  displayName: "User Name",
+  isVideo: true,
+});
+
+// CallKit events
+useCallKitEvent("muted", (isMuted) => {
+  // Handle mute event
+});
+
+```
+
+### After
+
+CallKit integration is now handled automatically by the SDK when VoIP background mode is enabled. You no longer need to manually manage CallKit sessions.
+
+To enable background calls on iOS:
+
+**Expo:**
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "@fishjam-cloud/mobile-client",
+        {
+          "ios": {
+            "enableVoIPBackgroundMode": true
+          }
+        }
+      ]
+    ]
+  }
+}
+
+```
+
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index b8081ab..29f0160 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -334,6 +334,18 @@ const config: Config = {
         ...typedocConfig,
       },
     ],
+    [
+      "docusaurus-plugin-typedoc",
+      {
+        id: "react-native-client-api",
+        out: "docs/api/react-native-client",
+        entryPoints: [
+          "./packages/mobile-client-sdk/packages/react-native-client/src/index.tsx",
+        ],
+        tsconfig: "./packages/mobile-client-sdk/packages/react-native-client/tsconfig.json",
+        ...typedocConfig,
+      },
+    ],
     [
       "docusaurus-plugin-typedoc",
       {
diff --git a/package.json b/package.json
index e7993eb..ac2c103 100644
--- a/package.json
+++ b/package.json
@@ -33,6 +33,7 @@
     "@fishjam-cloud/js-server-sdk": "link:./packages/js-server-sdk/packages/js-server-sdk",
     "@fishjam-cloud/mobile-client": "link:./packages/web-client-sdk/packages/mobile-client",
     "@fishjam-cloud/react-client": "link:./packages/web-client-sdk/packages/react-client",
+    "@fishjam-cloud/react-native-client": "link:./packages/mobile-client-sdk/packages/react-native-client",
     "@mdx-js/react": "^3.1.0",
     "@shikijs/rehype": "^3.6.0",
     "@shikijs/transformers": "^3.6.0",
diff --git a/scripts/prepare.sh b/scripts/prepare.sh
index 12a8fb5..5ea3297 100755
--- a/scripts/prepare.sh
+++ b/scripts/prepare.sh
@@ -29,6 +29,10 @@ cd $ROOTDIR
 cd packages/web-client-sdk/packages/mobile-client/
 yarn && yarn build
 
+cd $ROOTDIR
+cd packages/mobile-client-sdk/packages/react-native-client/
+yarn && yarn build
+
 cd $ROOTDIR
 cd packages/js-server-sdk/
 yarn && yarn build