@kaleem766/react-native-incoming-call 0.1.0

package/IncomingCall.podspec

@@ -0,0 +1,29 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "IncomingCall"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/Muhammadkaleem/react-native-incoming-call.git.git", :tag => "#{s.version}" }
+
+  s.source_files = [
+    "ios/**/*.{swift}",
+    "ios/**/*.{m,mm}",
+    "cpp/**/*.{hpp,cpp}",
+  ]
+
+  s.dependency 'React-jsi'
+  s.dependency 'React-callinvoker'
+
+  load 'nitrogen/generated/ios/IncomingCall+autolinking.rb'
+  add_nitrogen_files(s)
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 MuhammadKaleem
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,280 @@
+# react-native-incoming-call
+
+> Full-screen incoming call UI for React Native — works on foreground, background, and lock screen on Android. Built on [Nitro Modules](https://nitro.margelo.com/) for maximum native performance.
+
+---
+
+## Features
+
+- Full-screen incoming call activity shown above the lock screen
+- Wakes the device screen and dismisses the keyguard automatically
+- Works in foreground, background, and killed-app states
+- Foreground service keeps the call alive when the app is not running
+- Answer / Reject buttons with event callbacks to JavaScript
+- Auto-timeout with configurable duration
+- Customisable caller name, avatar, background colour, and call type
+- Inline `IncomingCallView` Nitro View for embedding in your own React Native screen
+- Event-driven API — subscribe with a simple `addEventListener` / cleanup function
+
+---
+
+## Platform support
+
+| Platform | Support |
+|----------|---------|
+| Android | ✅ Full support |
+| iOS | 🔜 Planned (CallKit) |
+
+---
+
+## Installation
+
+```bash
+# npm
+npm install react-native-incoming-call react-native-nitro-modules
+
+# yarn
+yarn add react-native-incoming-call react-native-nitro-modules
+```
+
+[react-native-nitro-modules](https://nitro.margelo.com/) is a required peer dependency.
+
+### Android permissions
+
+The library merges its own `AndroidManifest.xml` automatically. If you need to declare them manually, add the following to your app's `AndroidManifest.xml`:
+
+```xml
+<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />
+<uses-permission android:name="android.permission.WAKE_LOCK" />
+<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+<uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL" />
+<uses-permission android:name="android.permission.VIBRATE" />
+```
+
+---
+
+## Quick start
+
+```typescript
+import IncomingCall from 'react-native-incoming-call';
+
+// Show the incoming call screen (from a push notification handler, etc.)
+await IncomingCall.display({
+  uuid: 'call-abc-123',
+  callerName: 'John Doe',
+  avatar: 'https://example.com/avatar.jpg',
+  callType: 'audio',          // 'audio' | 'video'
+  backgroundColor: '#1A1A2E',
+  timeout: 20000,             // auto-reject after 20 s
+});
+```
+
+---
+
+## API reference
+
+### `IncomingCall.display(options)`
+
+Starts the foreground service and launches the full-screen call activity.
+
+```typescript
+IncomingCall.display({
+  uuid: string;             // unique call ID (required)
+  callerName: string;       // caller display name (required)
+  avatar?: string;          // remote avatar URL
+  callType?: 'audio' | 'video';  // defaults to 'audio'
+  backgroundColor?: string; // hex colour, e.g. '#1A1A2E'
+  timeout?: number;         // ms before auto-reject, default 30000
+}): Promise<void>
+```
+
+### `IncomingCall.answer(uuid)`
+
+Programmatically answer the call and emit `onAnswer`.
+
+```typescript
+await IncomingCall.answer('call-abc-123');
+```
+
+### `IncomingCall.reject(uuid)`
+
+Programmatically reject the call and emit `onReject`.
+
+```typescript
+await IncomingCall.reject('call-abc-123');
+```
+
+### `IncomingCall.end(uuid)`
+
+End an active call and stop the foreground service.
+
+```typescript
+await IncomingCall.end('call-abc-123');
+```
+
+### `IncomingCall.addEventListener(event, listener)`
+
+Subscribe to a call lifecycle event. Returns an unsubscribe function.
+
+```typescript
+const unsubscribe = IncomingCall.addEventListener('onAnswer', (data) => {
+  console.log('Answered:', data.uuid, data.timestamp);
+});
+
+// later…
+unsubscribe();
+```
+
+| Event | When fired |
+|-------|-----------|
+| `onAnswer` | User taps Accept or `answer()` is called |
+| `onReject` | User taps Decline or `reject()` is called |
+| `onTimeout` | Timeout elapsed with no user action |
+
+### `IncomingCall.removeEventListener(event, listener)`
+
+Alternative to calling the returned unsubscribe function.
+
+```typescript
+IncomingCall.removeEventListener('onAnswer', myListener);
+```
+
+---
+
+## Event data shape
+
+```typescript
+interface IncomingCallEventData {
+  uuid: string;       // the call ID passed to display()
+  timestamp: number;  // Unix epoch ms
+}
+```
+
+---
+
+## IncomingCallView (Nitro View)
+
+Embed an inline call UI inside your own React Native screen (foreground use-case).
+
+```tsx
+import { IncomingCallView } from 'react-native-incoming-call';
+
+<IncomingCallView
+  color="#1A1A2E"
+  callerName="John Doe"
+  callType="audio"
+  style={{ width: '100%', height: 220, borderRadius: 16 }}
+/>
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `color` | `string` | `"#1A1A2E"` | Background colour (hex) |
+| `callerName` | `string` | — | Caller display name |
+| `avatar` | `string` | — | Avatar URL |
+| `callType` | `string` | `"audio"` | `"audio"` or `"video"` |
+| `timeout` | `number` | `30000` | Auto-reject timeout (ms) |
+
+**Methods** (via ref):
+
+```tsx
+const ref = useRef<IncomingCallViewRef>(null);
+
+ref.current?.answerCall();
+ref.current?.rejectCall();
+```
+
+---
+
+## Full example
+
+```tsx
+import React, { useEffect } from 'react';
+import { Button } from 'react-native';
+import IncomingCall from 'react-native-incoming-call';
+
+export default function App() {
+  useEffect(() => {
+    const unsubAnswer  = IncomingCall.addEventListener('onAnswer',  (d) => console.log('answered', d.uuid));
+    const unsubReject  = IncomingCall.addEventListener('onReject',  (d) => console.log('rejected', d.uuid));
+    const unsubTimeout = IncomingCall.addEventListener('onTimeout', (d) => console.log('timeout',  d.uuid));
+
+    return () => {
+      unsubAnswer();
+      unsubReject();
+      unsubTimeout();
+    };
+  }, []);
+
+  const call = () =>
+    IncomingCall.display({
+      uuid: `call-${Date.now()}`,
+      callerName: 'Jane Smith',
+      callType: 'video',
+      backgroundColor: '#0D1B2A',
+      timeout: 15000,
+    });
+
+  return <Button title="Simulate Incoming Call" onPress={call} />;
+}
+```
+
+See the [`example/`](example/) directory for the full working demo app.
+
+---
+
+## Architecture
+
+```
+react-native-incoming-call
+├── src/
+│   ├── index.tsx                 JS/TS public API + event manager
+│   └── IncomingCall.nitro.ts     Nitro spec (props & methods)
+├── android/
+│   └── src/main/java/…
+│       ├── IncomingCallModule.kt     RN bridge — display/answer/reject/end
+│       ├── IncomingCallActivity.kt   Full-screen lock-screen activity
+│       ├── IncomingCallService.kt    Foreground service (phoneCall type)
+│       ├── IncomingCall.kt           HybridIncomingCall Nitro View
+│       └── IncomingCallPackage.kt    Package registration
+└── example/                      Demo app
+```
+
+**Call flow:**
+
+```
+JS: IncomingCall.display()
+  → IncomingCallModule (Kotlin)
+    → IncomingCallService (foreground, keeps alive in background/killed)
+      → IncomingCallActivity (lock screen, wake, full-screen UI)
+        → user taps Accept / Decline
+          → broadcast → IncomingCallModule → JS event (onAnswer / onReject)
+```
+
+---
+
+## Requirements
+
+| Requirement | Version |
+|-------------|---------|
+| React Native | 0.73+ |
+| react-native-nitro-modules | 0.35+ |
+| Android minSdk | 24 (Android 7.0) |
+| compileSdk | 36 |
+| Kotlin | 2.0+ |
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+Pull requests are welcome. For major changes, please open an issue first.
+
+## License
+
+MIT © [MuhammadKaleem](https://github.com/Muhammadkaleem)
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob) + [Nitro Modules](https://nitro.margelo.com/)

package/android/CMakeLists.txt

@@ -0,0 +1,24 @@
+project(incomingcall)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(PACKAGE_NAME incomingcall)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+# Define C++ library and add all sources
+add_library(${PACKAGE_NAME} SHARED src/main/cpp/cpp-adapter.cpp)
+
+# Add Nitrogen specs :)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/incomingcall+autolinking.cmake)
+
+# Set up local includes
+include_directories("src/main/cpp" "../cpp")
+
+find_library(LOG_LIB log)
+
+# Link all libraries together
+target_link_libraries(
+        ${PACKAGE_NAME}
+        ${LOG_LIB}
+        android # <-- Android core
+)

package/android/build.gradle

@@ -0,0 +1,118 @@
+buildscript {
+  ext.IncomingCall = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 35,
+    targetSdkVersion: 35
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return IncomingCall[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+apply from: '../nitrogen/generated/android/incomingcall+autolinking.gradle'
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.margelo.nitro.incomingcall"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+
+        buildTypes {
+          debug {
+            cppFlags "-O1 -g"
+          }
+          release {
+            cppFlags "-O2"
+          }
+        }
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  packagingOptions {
+    excludes = [
+      "META-INF",
+      "META-INF/**",
+      "**/libc++_shared.so",
+      "**/libfbjni.so",
+      "**/libjsi.so",
+      "**/libfolly_json.so",
+      "**/libfolly_runtime.so",
+      "**/libglog.so",
+      "**/libhermes.so",
+      "**/libhermes-executor-debug.so",
+      "**/libhermes_executor.so",
+      "**/libreactnative.so",
+      "**/libreactnativejni.so",
+      "**/libturbomodulejsijni.so",
+      "**/libreact_nativemodule_core.so",
+      "**/libjscexecutor.so"
+    ]
+  }
+
+  buildFeatures {
+    buildConfig true
+    prefab true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation project(":react-native-nitro-modules")
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,35 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <!-- Required permissions for incoming call functionality -->
+    <uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />
+    <uses-permission android:name="android.permission.WAKE_LOCK" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL" />
+    <uses-permission android:name="android.permission.VIBRATE" />
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
+
+    <application>
+
+        <!-- Full-screen incoming call activity shown on lock screen -->
+        <activity
+            android:name=".IncomingCallActivity"
+            android:exported="true"
+            android:launchMode="singleInstance"
+            android:showOnLockScreen="true"
+            android:turnScreenOn="true"
+            android:excludeFromRecents="true"
+            android:taskAffinity="com.margelo.nitro.incomingcall.incoming"
+            android:configChanges="orientation|screenSize|keyboardHidden"
+            android:theme="@style/Theme.AppCompat.NoActionBar" />
+
+        <!-- Foreground service to keep the call alive in background/killed state -->
+        <service
+            android:name=".IncomingCallService"
+            android:exported="false"
+            android:foregroundServiceType="phoneCall"
+            android:stopWithTask="false" />
+
+    </application>
+
+</manifest>
+

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,6 @@
+#include <jni.h>
+#include "incomingcallOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return margelo::nitro::incomingcall::initialize(vm);
+}