Alaznah
Get Started

Install @alaznah/calling in a React Native or Expo development build.

Installation

Requirements

  • React Native 0.76+ recommended (see package peers for your release)
  • iOS 13+ / Android API 24+
  • React Native CLI app, or Expo development build
  • Working mic (and camera for video) on a physical device for real call tests

Expo Go will not load the native calling modules.

Install the package

bash
npm install @alaznah/calling
bash
yarn add @alaznah/calling
bash
pnpm add @alaznah/calling

Install any peer dependencies your package manager reports (for example media and permissions packages required by your RN version).

iOS

bash
cd ios && pod install && cd ..

Add microphone / camera usage strings — see Permissions.

For background / CallKit ringing, also configure PushKit and capabilities — see Push Notifications.

Android

Permissions and (optional) Firebase messaging are required for push wake. Minimum permissions are listed in Permissions.

Expo (development build)

The package ships an Expo config plugin:

json
{
  "expo": {
    "plugins": ["@alaznah/calling"]
  }
}

Then create a new native build (eas build or npx expo prebuild + run). Do not rely on Expo Go.

Rebuild native binaries

After installing or changing native config, rebuild the app (Xcode / Gradle / EAS). Metro reload alone is not enough for first install.

Verify import

ts
import {
  CallingProvider,
  CallingScreen,
  requestCallPermissions,
  DEFAULT_HOSTED_SIGNALING_URL,
} from '@alaznah/calling';

UI-only deep imports (optional):

ts
import { IncomingCallScreen, ActiveCallScreen } from '@alaznah/calling/ui';

Next