react-native-nitro-location-tracking 0.1.18 → 0.1.21

package/README.md

@@ -14,6 +14,7 @@ A high-performance React Native location tracking library built with [Nitro Modu
 - **Smooth map marker animations** via `LocationSmoother`
 - **Bearing calculation** utilities for rotation/heading
 - **Foreground notifications** (Android foreground service, iOS local notifications)
+- **Live Activity / Dynamic Island** (iOS 16.2+) — show a delivery card on the Lock Screen and Dynamic Island that updates in real time
 - **Permission helpers** for fine, background, and notification permissions
 - **Built on Nitro Modules** for near-native performance via JSI
 
@@ -597,6 +598,117 @@ NitroLocationModule.onPermissionStatusChange((status) => {
 | iOS      | `locationManagerDidChangeAuthorization` delegate | Immediately when the user changes permission (system dialog, Settings, MDM) |
 | Android  | `ProcessLifecycleOwner` lifecycle observer | When the app returns to foreground after the user changes permission in Settings |
 
+### Live Activity (iOS Dynamic Island & Lock Screen)
+
+Show a live delivery card on the iOS Lock Screen and Dynamic Island that updates in real time as the order progresses. Android calls are safe no-ops.
+
+#### iOS Prerequisites (one-time setup)
+
+1. **Create a Widget Extension** in Xcode:
+   `File → New → Target → Widget Extension` — uncheck "Include Configuration App Intent"
+
+2. **Copy the widget file** from the published package into your widget extension folder:
+
+   ```sh
+   # from your project root
+   cp node_modules/react-native-nitro-location-tracking/ios/widget/CourierWidgetLiveActivity.swift \
+      ios/YourWidgetExtension/CourierWidgetLiveActivity.swift
+   ```
+
+   Then in Xcode, add the copied file to the widget extension target's **Compile Sources**.
+
+3. **Replace** the generated bundle file (`YourWidgetBundle.swift`) with:
+
+   ```swift
+   import WidgetKit
+   import SwiftUI
+
+   @main
+   struct YourWidgetBundle: WidgetBundle {
+       var body: some Widget {
+           CourierWidgetLiveActivity()
+       }
+   }
+   ```
+
+4. **Delete** the other files Xcode generated (`YourWidget.swift`, `YourWidgetControl.swift`, `AppIntent.swift`).
+
+5. **Add to your main app's `Info.plist`**:
+
+   ```xml
+   <key>NSSupportsLiveActivities</key>
+   <true/>
+   ```
+
+6. **Verify embedding**: Main app target → **General** → **Frameworks, Libraries, and Embedded Content** → your `.appex` should be listed as **Embed Without Signing**.
+
+7. On the device, go to **Settings → [Your App] → Live Activities** and make sure it is **ON**.
+
+> Live Activities do not work in the iOS Simulator. Test on a real device running iOS 16.2+.
+> Dynamic Island UI requires iPhone 14 Pro or later.
+
+#### Usage
+
+```tsx
+import NitroLocation, {
+  isLiveActivitySupported,
+} from 'react-native-nitro-location-tracking';
+import type { LiveActivityState } from 'react-native-nitro-location-tracking';
+
+// Guard — only call on iOS
+if (!isLiveActivitySupported()) return;
+
+// Start a Live Activity
+try {
+  NitroLocation.startLiveActivity(
+    'ORD-9981',           // orderId
+    'John Doe',           // customerName
+    '42 Elm Street',      // deliveryAddress
+    2,                    // orderCount
+    'picking_up',         // status
+    'Picking up order',   // statusText (localised label shown on widget)
+    18,                   // estimatedMinutes
+    4500                  // distanceMeters
+  );
+} catch (e) {
+  // Thrown when Live Activities are disabled in Settings
+  Alert.alert('Live Activity', String(e));
+}
+
+// Update as the delivery progresses
+const nextState: LiveActivityState = {
+  status: 'on_the_way',
+  statusText: 'On the way',
+  estimatedMinutes: 12,
+  distanceMeters: 2800,
+};
+NitroLocation.updateLiveActivity(
+  nextState.status,
+  nextState.statusText,
+  nextState.estimatedMinutes,
+  nextState.distanceMeters
+);
+
+// End when delivered
+NitroLocation.endLiveActivity();
+```
+
+**Status values and their meaning:**
+
+| `status`      | Widget emoji | Typical use                    |
+| ------------- | ------------ | ------------------------------ |
+| `picking_up`  | 📦           | Courier heading to restaurant  |
+| `on_the_way`  | 🚗           | En route to customer           |
+| `arriving`    | 🏁           | Less than ~1 min away          |
+| `delivered`   | ✅           | Order handed over              |
+
+**Platform behavior:**
+
+| Platform | Behavior |
+| -------- | -------- |
+| iOS 16.2+ | Shows on Lock Screen; Dynamic Island on iPhone 14 Pro+ |
+| Android   | No-op — calls are safe to make cross-platform |
+
 ## API Reference
 
 ### Types
@@ -741,6 +853,9 @@ type PermissionStatus =
 | `getLocationPermissionStatus()`              | `PermissionStatus`          | Check current location permission without prompting                                      |
 | `requestLocationPermission()`                | `Promise<PermissionStatus>` | Request location permission and return the resulting status                              |
 | `onPermissionStatusChange(callback)`         | `void`                      | Register a callback that fires when location permission status changes                   |
+| `startLiveActivity(orderId, customerName, deliveryAddress, orderCount, status, statusText, estimatedMinutes, distanceMeters)` | `void` | Start a Live Activity on the Lock Screen / Dynamic Island (iOS 16.2+ only; no-op on Android) |
+| `updateLiveActivity(status, statusText, estimatedMinutes, distanceMeters)` | `void` | Push a state update to the running Live Activity |
+| `endLiveActivity()`                          | `void`                      | End and dismiss the Live Activity immediately                                            |
 | `showLocalNotification(title, body)`         | `void`                      | Show a local notification                                                                |
 | `updateForegroundNotification(title, body)`  | `void`                      | Update the foreground service notification                                               |
 | `destroy()`                                  | `void`                      | Stop tracking and disconnect                                                             |
@@ -753,6 +868,8 @@ type PermissionStatus =
 | `calculateBearing(from, to)`  | Calculate bearing between two coordinates (degrees, 0-360) |
 | `shortestRotation(from, to)`  | Calculate shortest rotation path to avoid spinning         |
 | `requestLocationPermission()` | Request location + notification permissions (Android)      |
+| `isLiveActivitySupported()`   | Returns `true` on iOS, `false` on Android                  |
+| `LiveActivityState`           | Type for `{ status, statusText, estimatedMinutes, distanceMeters }` passed to start/update |
 
 ### Pure C++ Math Engine
 

package/android/src/main/java/com/margelo/nitro/nitrolocationtracking/LocationEngine.kt

@@ -21,12 +21,14 @@ class LocationEngine(private val context: Context) {
 
   var onLocation: ((LocationData) -> Unit)? = null
   var onMotionChange: ((Boolean) -> Unit)? = null
+  var onMockLocationChanged: ((Boolean) -> Unit)? = null
   var dbWriter: NativeDBWriter? = null
 //  var currentRideId: String? = null
   var rejectMockLocations: Boolean = false
   val speedMonitor = SpeedMonitor()
   val tripCalculator = TripCalculator()
   private var lastSpeed = 0f
+  private var lastMockState: Boolean? = null
   private var tracking = false
   var lastLocation: Location? = null
     private set
@@ -116,8 +118,16 @@ class LocationEngine(private val context: Context) {
     lastLocation = location
     val data = locationToData(location)
 
+    // Check mock location state change and notify
+    val isMock = data.isMockLocation == true
+    if (isMock != lastMockState) {
+      lastMockState = isMock
+      Log.d(TAG, "Mock location state changed: $isMock")
+      onMockLocationChanged?.invoke(isMock)
+    }
+
     // Skip mock locations if rejection is enabled
-    if (rejectMockLocations && data.isMockLocation == true) {
+    if (rejectMockLocations && isMock) {
       Log.d(TAG, "Rejecting mock location")
       return
     }

package/android/src/main/java/com/margelo/nitro/nitrolocationtracking/MockLocationMonitor.kt

@@ -1,23 +1,26 @@
 package com.margelo.nitro.nitrolocationtracking
 
 import android.annotation.SuppressLint
-import android.app.AppOpsManager
 import android.content.Context
+import android.location.Location
 import android.os.Build
 import android.os.Handler
 import android.os.Looper
 import android.provider.Settings
 import android.util.Log
+import com.google.android.gms.location.CurrentLocationRequest
+import com.google.android.gms.location.LocationServices
+import com.google.android.gms.location.Priority
 
 /**
- * Periodically polls whether a mock/fake GPS provider is active on the device.
- * This works independently of location tracking — it detects the presence of
- * mock location apps (e.g. Fake GPS, Mock Locations) at the system level.
+ * Periodically checks whether mock/fake GPS is actively being used on the device.
+ * Works independently of location tracking — can be used on login/verify screens.
  *
- * On each poll it checks:
+ * Detection strategy:
  * - Pre-API 23: Settings.Secure.ALLOW_MOCK_LOCATION
- * - API 23+: AppOpsManager OP_MOCK_LOCATION (op code 58)
- * - Also checks all installed packages for mock location permission
+ * - API 23+: Requests a single location via FusedLocationProviderClient and checks
+ *   Location.isMock / isFromMockProvider. This is the only reliable way to know
+ *   if mock location is currently ACTIVE (not just if a mock app is installed).
  *
  * The callback fires only when the state changes (deduplicated).
  */
@@ -25,11 +28,11 @@ class MockLocationMonitor(private val context: Context) {
 
     companion object {
         private const val TAG = "MockLocationMonitor"
-        /** Default poll interval in milliseconds */
         private const val DEFAULT_POLL_INTERVAL_MS = 3000L
     }
 
     private val mainHandler = Handler(Looper.getMainLooper())
+    private val fusedClient = LocationServices.getFusedLocationProviderClient(context)
     private var callback: ((Boolean) -> Unit)? = null
     private var lastState: Boolean? = null
     private var polling = false
@@ -38,18 +41,15 @@ class MockLocationMonitor(private val context: Context) {
     private val pollRunnable = object : Runnable {
         override fun run() {
             if (!polling) return
-            checkAndNotify()
+            checkMockLocation()
             mainHandler.postDelayed(this, pollIntervalMs)
         }
     }
 
     fun setCallback(callback: (Boolean) -> Unit) {
         this.callback = callback
-        // Emit current state immediately
-        val current = isMockLocationActive()
-        lastState = current
-        callback.invoke(current)
-        // Start polling
+        // Kick off an immediate check
+        checkMockLocation()
         startPolling()
     }
 
@@ -66,93 +66,66 @@ class MockLocationMonitor(private val context: Context) {
         Log.d(TAG, "Mock location polling stopped")
     }
 
-    private fun checkAndNotify() {
-        val current = isMockLocationActive()
-        if (current != lastState) {
-            lastState = current
-            Log.d(TAG, "Mock location state changed: isMockEnabled=$current")
-            callback?.invoke(current)
+    private fun notifyIfChanged(isMock: Boolean) {
+        if (isMock != lastState) {
+            lastState = isMock
+            Log.d(TAG, "Mock location state changed: isMockEnabled=$isMock")
+            callback?.invoke(isMock)
         }
     }
 
-    /**
-     * Comprehensive check for mock location activity on the device.
-     */
-    @SuppressLint("DiscouragedPrivateApi")
-    fun isMockLocationActive(): Boolean {
-        // Pre-API 23: check the global mock location setting
+    @SuppressLint("MissingPermission")
+    private fun checkMockLocation() {
+        // Pre-API 23: use the global settings flag
         if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
             @Suppress("DEPRECATION")
             val mockSetting = Settings.Secure.getString(
                 context.contentResolver,
                 Settings.Secure.ALLOW_MOCK_LOCATION
             )
-            return mockSetting == "1"
+            notifyIfChanged(mockSetting == "1")
+            return
         }
 
-        // API 23+: scan ALL installed packages for OP_MOCK_LOCATION permission.
-        // The previous approach only checked our own UID which always returned false
-        // since the mock location app (not ours) holds the permission.
+        // API 23+: request a current location and check isMock flag
         try {
-            val appOps = context.getSystemService(Context.APP_OPS_SERVICE) as AppOpsManager
-            val opMockLocation = 58 // OP_MOCK_LOCATION
-            val checkOp = AppOpsManager::class.java.getMethod(
-                "checkOp",
-                Int::class.javaPrimitiveType,
-                Int::class.javaPrimitiveType,
-                String::class.java
-            )
+            val request = CurrentLocationRequest.Builder()
+                .setPriority(Priority.PRIORITY_HIGH_ACCURACY)
+                .setMaxUpdateAgeMillis(5000)
+                .build()
 
-            val pm = context.packageManager
-            @Suppress("DEPRECATION")
-            val packages = pm.getInstalledApplications(0)
-            for (appInfo in packages) {
-                // Skip our own package
-                if (appInfo.packageName == context.packageName) continue
-                try {
-                    val result = checkOp.invoke(
-                        appOps, opMockLocation, appInfo.uid, appInfo.packageName
-                    ) as Int
-                    if (result == AppOpsManager.MODE_ALLOWED) {
-                        Log.d(TAG, "Mock location provider detected: ${appInfo.packageName}")
-                        return true
+            fusedClient.getCurrentLocation(request, null)
+                .addOnSuccessListener { location: Location? ->
+                    if (location != null) {
+                        val isMock = isLocationMock(location)
+                        mainHandler.post { notifyIfChanged(isMock) }
+                    } else {
+                        // No location available — try last location as fallback
+                        fusedClient.lastLocation.addOnSuccessListener { lastLoc: Location? ->
+                            if (lastLoc != null) {
+                                val isMock = isLocationMock(lastLoc)
+                                mainHandler.post { notifyIfChanged(isMock) }
+                            }
+                        }
                     }
-                } catch (_: Exception) {
-                    // Some packages may not be queryable — skip
                 }
-            }
-        } catch (e: Exception) {
-            Log.w(TAG, "Could not check mock location app ops: ${e.message}")
-        }
-
-        // Fallback: check for known mock location app package names
-        try {
-            val pm = context.packageManager
-            val knownMockApps = listOf(
-                "com.lexa.fakegps",
-                "com.incorporateapps.fakegps.fre",
-                "com.fakegps.mock",
-                "com.lkr.fakegps",
-                "com.fake.gps.go.location.spoofer.free",
-                "com.theappninjas.gpsjoystick",
-                "com.evezzon.fgl",
-                "com.mock.location"
-            )
-            for (pkg in knownMockApps) {
-                try {
-                    @Suppress("DEPRECATION")
-                    pm.getApplicationInfo(pkg, 0)
-                    Log.d(TAG, "Known mock location app detected: $pkg")
-                    return true
-                } catch (_: Exception) {
-                    // Not installed
+                .addOnFailureListener { e ->
+                    Log.w(TAG, "Failed to get current location for mock check: ${e.message}")
                 }
-            }
+        } catch (e: SecurityException) {
+            Log.w(TAG, "No location permission for mock check: ${e.message}")
         } catch (e: Exception) {
-            Log.w(TAG, "Could not check for mock location apps: ${e.message}")
+            Log.w(TAG, "Error checking mock location: ${e.message}")
         }
+    }
 
-        return false
+    private fun isLocationMock(location: Location): Boolean {
+        return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+            location.isMock
+        } else {
+            @Suppress("DEPRECATION")
+            location.isFromMockProvider
+        }
     }
 
     fun destroy() {

package/android/src/main/java/com/margelo/nitro/nitrolocationtracking/NitroLocationTracking.kt

@@ -548,6 +548,28 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
         return geofenceManager?.distanceTo(regionId, locationEngine?.lastLocation) ?: -1.0
     }
 
+    // === Live Activity (Android no-op — Dynamic Island is iOS-only) ===
+
+    override fun startLiveActivity(
+        orderId: String,
+        customerName: String,
+        deliveryAddress: String,
+        orderCount: Double,
+        status: String,
+        statusText: String,
+        estimatedMinutes: Double,
+        distanceMeters: Double
+    ) { /* no-op */ }
+
+    override fun updateLiveActivity(
+        status: String,
+        statusText: String,
+        estimatedMinutes: Double,
+        distanceMeters: Double
+    ) { /* no-op */ }
+
+    override fun endLiveActivity() { /* no-op */ }
+
     // === Notifications ===
 
     override fun showLocalNotification(title: String, body: String) {

package/ios/LiveActivityManager.swift

@@ -0,0 +1,116 @@
+import Foundation
+
+// Wraps ActivityKit so the rest of the module stays buildable on iOS < 16.2
+// and on macOS/tvOS where ActivityKit is unavailable.
+
+#if canImport(ActivityKit)
+import ActivityKit
+
+// ─── Activity Attributes ──────────────────────────────────────────────────────
+
+public struct CourierActivityAttributes: ActivityAttributes {
+    // Custom activityType so the widget extension (different module) can match this activity.
+    public static var activityType: String { "CourierDeliveryActivity" }
+
+    public let orderId: String
+    public let customerName: String
+    public let deliveryAddress: String
+    public let orderCount: Int
+
+    public struct ContentState: Codable, Hashable {
+        public let status: String
+        public let statusText: String
+        public let estimatedMinutes: Int
+        public let distanceMeters: Double
+    }
+}
+
+// ─── Manager ─────────────────────────────────────────────────────────────────
+
+@available(iOS 16.2, *)
+final class LiveActivityManager {
+    static let shared = LiveActivityManager()
+
+    private init() {
+        // Recover any activity that was alive before the app restarted.
+        currentActivity = Activity<CourierActivityAttributes>.activities.first
+    }
+
+    private var currentActivity: Activity<CourierActivityAttributes>?
+
+    func start(
+        orderId: String,
+        customerName: String,
+        deliveryAddress: String,
+        orderCount: Int,
+        status: String,
+        statusText: String,
+        estimatedMinutes: Int,
+        distanceMeters: Double
+    ) throws {
+        guard ActivityAuthorizationInfo().areActivitiesEnabled else {
+            let appName = Bundle.main.object(forInfoDictionaryKey: "CFBundleDisplayName") as? String
+                ?? Bundle.main.object(forInfoDictionaryKey: "CFBundleName") as? String
+                ?? "the app"
+            throw NSError(
+                domain: "com.nitro.liveactivity",
+                code: 1,
+                userInfo: [NSLocalizedDescriptionKey: "Live Activities are disabled. Enable them in Settings → \(appName) → Live Activities."]
+            )
+        }
+
+        if let existing = currentActivity {
+            Task { await existing.end(nil, dismissalPolicy: .immediate) }
+            currentActivity = nil
+        }
+
+        let attributes = CourierActivityAttributes(
+            orderId: orderId,
+            customerName: customerName,
+            deliveryAddress: deliveryAddress,
+            orderCount: orderCount
+        )
+        let content = ActivityContent(
+            state: CourierActivityAttributes.ContentState(
+                status: status,
+                statusText: statusText,
+                estimatedMinutes: estimatedMinutes,
+                distanceMeters: distanceMeters
+            ),
+            staleDate: Date().addingTimeInterval(3600)
+        )
+
+        currentActivity = try Activity.request(attributes: attributes, content: content, pushType: nil)
+    }
+
+    func update(status: String, statusText: String, estimatedMinutes: Int, distanceMeters: Double) {
+        // Recover orphaned reference if the app was restarted between start and update.
+        if currentActivity == nil {
+            currentActivity = Activity<CourierActivityAttributes>.activities.first
+        }
+        guard let activity = currentActivity else { return }
+
+        let content = ActivityContent(
+            state: CourierActivityAttributes.ContentState(
+                status: status,
+                statusText: statusText,
+                estimatedMinutes: estimatedMinutes,
+                distanceMeters: distanceMeters
+            ),
+            staleDate: Date().addingTimeInterval(3600)
+        )
+        Task { await activity.update(content) }
+    }
+
+    func end() {
+        // Recover orphaned reference if the app was restarted between start and end.
+        if currentActivity == nil {
+            currentActivity = Activity<CourierActivityAttributes>.activities.first
+        }
+        guard let activity = currentActivity else { return }
+        currentActivity = nil
+        Task { await activity.end(nil, dismissalPolicy: .immediate) }
+    }
+}
+
+#endif // canImport(ActivityKit)

package/ios/NitroLocationTracking.swift

@@ -329,6 +329,60 @@ class NitroLocationTracking: HybridNitroLocationTrackingSpec {
         return geofenceManager.distanceTo(regionId: regionId, from: locationEngine.lastCLLocation)
     }
 
+    // MARK: - Live Activity
+
+    func startLiveActivity(
+        orderId: String,
+        customerName: String,
+        deliveryAddress: String,
+        orderCount: Double,
+        status: String,
+        statusText: String,
+        estimatedMinutes: Double,
+        distanceMeters: Double
+    ) throws {
+#if canImport(ActivityKit)
+        if #available(iOS 16.2, *) {
+            try LiveActivityManager.shared.start(
+                orderId: orderId,
+                customerName: customerName,
+                deliveryAddress: deliveryAddress,
+                orderCount: Int(orderCount),
+                status: status,
+                statusText: statusText,
+                estimatedMinutes: Int(estimatedMinutes),
+                distanceMeters: distanceMeters
+            )
+        }
+#endif
+    }
+
+    func updateLiveActivity(
+        status: String,
+        statusText: String,
+        estimatedMinutes: Double,
+        distanceMeters: Double
+    ) throws {
+#if canImport(ActivityKit)
+        if #available(iOS 16.2, *) {
+            LiveActivityManager.shared.update(
+                status: status,
+                statusText: statusText,
+                estimatedMinutes: Int(estimatedMinutes),
+                distanceMeters: distanceMeters
+            )
+        }
+#endif
+    }
+
+    func endLiveActivity() throws {
+#if canImport(ActivityKit)
+        if #available(iOS 16.2, *) {
+            LiveActivityManager.shared.end()
+        }
+#endif
+    }
+
     // MARK: - Notifications
 
     func showLocalNotification(title: String, body: String) throws {

package/ios/widget/CourierWidgetLiveActivity.swift

@@ -0,0 +1,226 @@
+// CourierWidgetLiveActivity.swift
+// react-native-nitro-location-tracking
+//
+// ─── HOW TO USE ──────────────────────────────────────────────────────────────
+//
+// 1. In Xcode, add a new Widget Extension target to your app:
+//    File → New → Target → Widget Extension
+//    Uncheck "Include Configuration App Intent"
+//
+// 2. Copy THIS file into the widget extension folder and add it to the
+//    widget extension target's "Compile Sources".
+//
+// 3. Delete the template files Xcode generated
+//    (WidgetName.swift, WidgetNameBundle.swift, Assets.xcassets is fine to keep).
+//
+// 4. Replace WidgetNameBundle.swift content with:
+//
+//    import WidgetKit
+//    import SwiftUI
+//
+//    @main
+//    struct YourWidgetBundle: WidgetBundle {
+//        var body: some Widget {
+//            CourierWidgetLiveActivity()
+//        }
+//    }
+//
+// 5. In your main app's Info.plist, add:
+//    <key>NSSupportsLiveActivities</key>
+//    <true/>
+//
+// 6. In Xcode, select your main app target → General →
+//    Frameworks, Libraries, and Embedded Content → verify the
+//    widget extension .appex is listed with "Embed Without Signing".
+//
+// Minimum deployment target: iOS 16.2
+// ─────────────────────────────────────────────────────────────────────────────
+
+import ActivityKit
+import WidgetKit
+import SwiftUI
+
+// MARK: - Attributes
+// Must mirror CourierActivityAttributes in LiveActivityManager.swift exactly.
+// The activityType string is what links the library's Activity.request() call
+// to this widget extension across Swift module boundaries.
+
+struct CourierActivityAttributes: ActivityAttributes {
+    static var activityType: String { "CourierDeliveryActivity" }
+
+    let orderId: String
+    let customerName: String
+    let deliveryAddress: String
+    let orderCount: Int
+
+    struct ContentState: Codable, Hashable {
+        let status: String       // "picking_up" | "on_the_way" | "arriving" | "delivered"
+        let statusText: String   // Localised label for the status
+        let estimatedMinutes: Int
+        let distanceMeters: Double
+    }
+}
+
+// MARK: - Helpers
+
+private func statusEmoji(_ status: String) -> String {
+    switch status {
+    case "picking_up": return "📦"
+    case "on_the_way":  return "🚗"
+    case "arriving":    return "🏁"
+    case "delivered":   return "✅"
+    default:            return "📍"
+    }
+}
+
+private func statusColor(_ status: String) -> Color {
+    switch status {
+    case "picking_up": return .orange
+    case "on_the_way": return .blue
+    case "arriving":   return Color(red: 0.1, green: 0.7, blue: 0.3)
+    case "delivered":  return .green
+    default:           return .gray
+    }
+}
+
+private func distanceText(_ meters: Double) -> String {
+    meters >= 1000
+        ? String(format: "%.1f km", meters / 1000)
+        : "\(Int(meters)) m"
+}
+
+private func safeDeliveryURL(orderId: String) -> URL? {
+    var components = URLComponents()
+    components.scheme = "nitrolocation"
+    components.host = "delivery"
+    components.path = "/\(orderId)"
+    return components.url
+}
+
+// MARK: - Lock Screen / Banner
+
+struct CourierLockScreenView: View {
+    let context: ActivityViewContext<CourierActivityAttributes>
+
+    var body: some View {
+        VStack(spacing: 8) {
+            HStack(alignment: .center) {
+                Text(statusEmoji(context.state.status))
+                    .font(.title2)
+                VStack(alignment: .leading, spacing: 2) {
+                    Text(context.state.statusText)
+                        .font(.headline)
+                    Text(context.attributes.customerName)
+                        .font(.subheadline)
+                        .foregroundStyle(.secondary)
+                }
+                Spacer()
+                VStack(alignment: .trailing, spacing: 2) {
+                    if context.isStale {
+                        Text("Updating…")
+                            .font(.caption2)
+                            .foregroundStyle(.orange)
+                    } else {
+                        Text("\(context.state.estimatedMinutes) min")
+                            .font(.title3)
+                            .fontWeight(.bold)
+                            .foregroundStyle(statusColor(context.state.status))
+                    }
+                    Text(distanceText(context.state.distanceMeters))
+                        .font(.caption)
+                        .foregroundStyle(.secondary)
+                }
+            }
+
+            Divider()
+
+            HStack {
+                Image(systemName: "location.fill")
+                    .font(.caption2)
+                    .foregroundStyle(.secondary)
+                Text(context.attributes.deliveryAddress)
+                    .font(.caption)
+                    .foregroundStyle(.secondary)
+                    .lineLimit(1)
+                Spacer()
+                Text(context.attributes.orderId)
+                    .font(.caption2)
+                    .foregroundStyle(.secondary)
+            }
+        }
+        .padding()
+        .activityBackgroundTint(Color(.systemBackground))
+        .activitySystemActionForegroundColor(.primary)
+    }
+}
+
+// MARK: - Widget
+
+struct CourierWidgetLiveActivity: Widget {
+    var body: some WidgetConfiguration {
+        ActivityConfiguration(for: CourierActivityAttributes.self) { context in
+            CourierLockScreenView(context: context)
+        } dynamicIsland: { context in
+            DynamicIsland {
+                DynamicIslandExpandedRegion(.leading) {
+                    HStack(spacing: 6) {
+                        Text(statusEmoji(context.state.status))
+                            .font(.title2)
+                        VStack(alignment: .leading, spacing: 1) {
+                            Text(context.state.statusText)
+                                .font(.caption)
+                                .fontWeight(.semibold)
+                            Text(context.attributes.customerName)
+                                .font(.caption2)
+                                .foregroundStyle(.secondary)
+                        }
+                    }
+                    .padding(.leading, 4)
+                }
+                DynamicIslandExpandedRegion(.trailing) {
+                    VStack(alignment: .trailing, spacing: 1) {
+                        Text("\(context.state.estimatedMinutes)")
+                            .font(.title)
+                            .fontWeight(.bold)
+                            .foregroundStyle(statusColor(context.state.status))
+                        Text("min")
+                            .font(.caption2)
+                            .foregroundStyle(.secondary)
+                    }
+                    .padding(.trailing, 4)
+                }
+                DynamicIslandExpandedRegion(.bottom) {
+                    HStack {
+                        Image(systemName: "location.fill")
+                            .font(.caption2)
+                            .foregroundStyle(.secondary)
+                        Text(context.attributes.deliveryAddress)
+                            .font(.caption)
+                            .foregroundStyle(.secondary)
+                            .lineLimit(1)
+                        Spacer()
+                        Text(distanceText(context.state.distanceMeters))
+                            .font(.caption)
+                            .fontWeight(.semibold)
+                    }
+                    .padding(.horizontal, 4)
+                    .padding(.bottom, 4)
+                }
+            } compactLeading: {
+                Text(statusEmoji(context.state.status))
+            } compactTrailing: {
+                Text("\(context.state.estimatedMinutes)m")
+                    .font(.caption2)
+                    .fontWeight(.bold)
+                    .foregroundStyle(statusColor(context.state.status))
+            } minimal: {
+                Text("\(context.state.estimatedMinutes)")
+                    .font(.caption2)
+                    .fontWeight(.bold)
+                    .foregroundStyle(statusColor(context.state.status))
+            }
+            .widgetURL(safeDeliveryURL(orderId: context.attributes.orderId))
+            .keylineTint(statusColor(context.state.status))
+        }
+    }
+}

package/lib/module/index.js

@@ -1,10 +1,20 @@
 "use strict";
 
 import { useState, useEffect, useCallback, useRef } from 'react';
+import { Platform } from 'react-native';
 import { NitroModules } from 'react-native-nitro-modules';
 const NitroLocationModule = NitroModules.createHybridObject('NitroLocationTracking');
 export const NitroLocationCalculations = NitroModules.createHybridObject('NitroLocationComplexLogicsCalculation');
 export default NitroLocationModule;
+
+// Live Activities are an iOS-only feature (Android calls are safe no-ops).
+// Use this guard before calling startLiveActivity / updateLiveActivity / endLiveActivity.
+export function isLiveActivitySupported() {
+  return Platform.OS === 'ios';
+}
+
+// Convenience type for the mutable state passed to startLiveActivity / updateLiveActivity.
+
 export { requestLocationPermission } from "./requestPermission.js";
 export { LocationSmoother } from "./LocationSmoother.js";
 export { shortestRotation, calculateBearing } from "./bearing.js";

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["useState","useEffect","useCallback","useRef","NitroModules","NitroLocationModule","createHybridObject","NitroLocationCalculations","requestLocationPermission","LocationSmoother","shortestRotation","calculateBearing","useDriverLocation","config","location","setLocation","isMoving","setIsMoving","isTracking","setIsTracking","configJson","JSON","stringify","trackingRef","parsed","parse","configure","onLocation","onMotionChange","current","stopTracking","startTracking","useRideConnection","connectionState","setConnectionState","lastMessage","setLastMessage","configureConnection","onConnectionStateChange","onMessage","disconnectWebSocket","connect","connectWebSocket","disconnect","send","m","sendMessage"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useState","useEffect","useCallback","useRef","Platform","NitroModules","NitroLocationModule","createHybridObject","NitroLocationCalculations","isLiveActivitySupported","OS","requestLocationPermission","LocationSmoother","shortestRotation","calculateBearing","useDriverLocation","config","location","setLocation","isMoving","setIsMoving","isTracking","setIsTracking","configJson","JSON","stringify","trackingRef","parsed","parse","configure","onLocation","onMotionChange","current","stopTracking","startTracking","useRideConnection","connectionState","setConnectionState","lastMessage","setLastMessage","configureConnection","onConnectionStateChange","onMessage","disconnectWebSocket","connect","connectWebSocket","disconnect","send","m","sendMessage"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/NitroLocationTracking.nitro.d.ts

@@ -122,6 +122,9 @@ export interface NitroLocationTracking extends HybridObject<{
     getDistanceToGeofence(regionId: string): number;
     showLocalNotification(title: string, body: string): void;
     updateForegroundNotification(title: string, body: string): void;
+    startLiveActivity(orderId: string, customerName: string, deliveryAddress: string, orderCount: number, status: string, statusText: string, estimatedMinutes: number, distanceMeters: number): void;
+    updateLiveActivity(status: string, statusText: string, estimatedMinutes: number, distanceMeters: number): void;
+    endLiveActivity(): void;
     destroy(): void;
 }
 //# sourceMappingURL=NitroLocationTracking.nitro.d.ts.map

package/lib/typescript/src/NitroLocationTracking.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NitroLocationTracking.nitro.d.ts","sourceRoot":"","sources":["../../../src/NitroLocationTracking.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NitroLocationTracking.nitro.d.ts","sourceRoot":"","sources":["../../../src/NitroLocationTracking.nitro.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/index.d.ts

@@ -2,6 +2,13 @@ import type { NitroLocationTracking, LocationData, LocationConfig, ConnectionCon
 declare const NitroLocationModule: NitroLocationTracking;
 export declare const NitroLocationCalculations: import("./NitroLocationComplexLogicsCalculation.nitro").NitroLocationComplexLogicsCalculation;
 export default NitroLocationModule;
+export declare function isLiveActivitySupported(): boolean;
+export type LiveActivityState = {
+    status: 'picking_up' | 'on_the_way' | 'arriving' | 'delivered';
+    statusText: string;
+    estimatedMinutes: number;
+    distanceMeters: number;
+};
 export { requestLocationPermission } from './requestPermission';
 export { LocationSmoother } from './LocationSmoother';
 export { shortestRotation, calculateBearing } from './bearing';

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,QAAA,MAAM,mBAAmB,uBAGtB,CAAC;AAEJ,eAAO,MAAM,yBAAyB,+FAEI,CAAC;AAE3C,eAAe,mBAAmB,CAAC;AACnC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,qCAAqC,EACrC,aAAa,EACb,aAAa,GACd,MAAM,+CAA+C,CAAC;AAEvD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc;;;;;;EAuCvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB;;;;;cAuBhC,MAAM;EAE/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,QAAA,MAAM,mBAAmB,uBAGtB,CAAC;AAEJ,eAAO,MAAM,yBAAyB,+FAEI,CAAC;AAE3C,eAAe,mBAAmB,CAAC;AAInC,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAGD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,qCAAqC,EACrC,aAAa,EACb,aAAa,GACd,MAAM,+CAA+C,CAAC;AAEvD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc;;;;;;EAuCvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB;;;;;cAuBhC,MAAM;EAE/B"}

package/nitrogen/generated/android/c++/JHybridNitroLocationTrackingSpec.cpp

@@ -333,6 +333,18 @@ namespace margelo::nitro::nitrolocationtracking {
     static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* title */, jni::alias_ref<jni::JString> /* body */)>("updateForegroundNotification");
     method(_javaPart, jni::make_jstring(title), jni::make_jstring(body));
   }
+  void JHybridNitroLocationTrackingSpec::startLiveActivity(const std::string& orderId, const std::string& customerName, const std::string& deliveryAddress, double orderCount, const std::string& status, const std::string& statusText, double estimatedMinutes, double distanceMeters) {
+    static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* orderId */, jni::alias_ref<jni::JString> /* customerName */, jni::alias_ref<jni::JString> /* deliveryAddress */, double /* orderCount */, jni::alias_ref<jni::JString> /* status */, jni::alias_ref<jni::JString> /* statusText */, double /* estimatedMinutes */, double /* distanceMeters */)>("startLiveActivity");
+    method(_javaPart, jni::make_jstring(orderId), jni::make_jstring(customerName), jni::make_jstring(deliveryAddress), orderCount, jni::make_jstring(status), jni::make_jstring(statusText), estimatedMinutes, distanceMeters);
+  }
+  void JHybridNitroLocationTrackingSpec::updateLiveActivity(const std::string& status, const std::string& statusText, double estimatedMinutes, double distanceMeters) {
+    static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* status */, jni::alias_ref<jni::JString> /* statusText */, double /* estimatedMinutes */, double /* distanceMeters */)>("updateLiveActivity");
+    method(_javaPart, jni::make_jstring(status), jni::make_jstring(statusText), estimatedMinutes, distanceMeters);
+  }
+  void JHybridNitroLocationTrackingSpec::endLiveActivity() {
+    static const auto method = javaClassStatic()->getMethod<void()>("endLiveActivity");
+    method(_javaPart);
+  }
   void JHybridNitroLocationTrackingSpec::destroy() {
     static const auto method = javaClassStatic()->getMethod<void()>("destroy");
     method(_javaPart);

package/nitrogen/generated/android/c++/JHybridNitroLocationTrackingSpec.hpp

@@ -96,6 +96,9 @@ namespace margelo::nitro::nitrolocationtracking {
     double getDistanceToGeofence(const std::string& regionId) override;
     void showLocalNotification(const std::string& title, const std::string& body) override;
     void updateForegroundNotification(const std::string& title, const std::string& body) override;
+    void startLiveActivity(const std::string& orderId, const std::string& customerName, const std::string& deliveryAddress, double orderCount, const std::string& status, const std::string& statusText, double estimatedMinutes, double distanceMeters) override;
+    void updateLiveActivity(const std::string& status, const std::string& statusText, double estimatedMinutes, double distanceMeters) override;
+    void endLiveActivity() override;
     void destroy() override;
 
   private:

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitrolocationtracking/HybridNitroLocationTrackingSpec.kt

@@ -260,6 +260,18 @@ abstract class HybridNitroLocationTrackingSpec: HybridObject() {
   @Keep
   abstract fun updateForegroundNotification(title: String, body: String): Unit
   
+  @DoNotStrip
+  @Keep
+  abstract fun startLiveActivity(orderId: String, customerName: String, deliveryAddress: String, orderCount: Double, status: String, statusText: String, estimatedMinutes: Double, distanceMeters: Double): Unit
+  
+  @DoNotStrip
+  @Keep
+  abstract fun updateLiveActivity(status: String, statusText: String, estimatedMinutes: Double, distanceMeters: Double): Unit
+  
+  @DoNotStrip
+  @Keep
+  abstract fun endLiveActivity(): Unit
+  
   @DoNotStrip
   @Keep
   abstract fun destroy(): Unit

package/nitrogen/generated/ios/c++/HybridNitroLocationTrackingSpecSwift.hpp

@@ -380,6 +380,24 @@ namespace margelo::nitro::nitrolocationtracking {
         std::rethrow_exception(__result.error());
       }
     }
+    inline void startLiveActivity(const std::string& orderId, const std::string& customerName, const std::string& deliveryAddress, double orderCount, const std::string& status, const std::string& statusText, double estimatedMinutes, double distanceMeters) override {
+      auto __result = _swiftPart.startLiveActivity(orderId, customerName, deliveryAddress, std::forward<decltype(orderCount)>(orderCount), status, statusText, std::forward<decltype(estimatedMinutes)>(estimatedMinutes), std::forward<decltype(distanceMeters)>(distanceMeters));
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
+    inline void updateLiveActivity(const std::string& status, const std::string& statusText, double estimatedMinutes, double distanceMeters) override {
+      auto __result = _swiftPart.updateLiveActivity(status, statusText, std::forward<decltype(estimatedMinutes)>(estimatedMinutes), std::forward<decltype(distanceMeters)>(distanceMeters));
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
+    inline void endLiveActivity() override {
+      auto __result = _swiftPart.endLiveActivity();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
     inline void destroy() override {
       auto __result = _swiftPart.destroy();
       if (__result.hasError()) [[unlikely]] {

package/nitrogen/generated/ios/swift/HybridNitroLocationTrackingSpec.swift

@@ -54,6 +54,9 @@ public protocol HybridNitroLocationTrackingSpec_protocol: HybridObject {
   func getDistanceToGeofence(regionId: String) throws -> Double
   func showLocalNotification(title: String, body: String) throws -> Void
   func updateForegroundNotification(title: String, body: String) throws -> Void
+  func startLiveActivity(orderId: String, customerName: String, deliveryAddress: String, orderCount: Double, status: String, statusText: String, estimatedMinutes: Double, distanceMeters: Double) throws -> Void
+  func updateLiveActivity(status: String, statusText: String, estimatedMinutes: Double, distanceMeters: Double) throws -> Void
+  func endLiveActivity() throws -> Void
   func destroy() throws -> Void
 }
 

package/nitrogen/generated/ios/swift/HybridNitroLocationTrackingSpec_cxx.swift

@@ -668,6 +668,39 @@ open class HybridNitroLocationTrackingSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func startLiveActivity(orderId: std.string, customerName: std.string, deliveryAddress: std.string, orderCount: Double, status: std.string, statusText: std.string, estimatedMinutes: Double, distanceMeters: Double) -> bridge.Result_void_ {
+    do {
+      try self.__implementation.startLiveActivity(orderId: String(orderId), customerName: String(customerName), deliveryAddress: String(deliveryAddress), orderCount: orderCount, status: String(status), statusText: String(statusText), estimatedMinutes: estimatedMinutes, distanceMeters: distanceMeters)
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func updateLiveActivity(status: std.string, statusText: std.string, estimatedMinutes: Double, distanceMeters: Double) -> bridge.Result_void_ {
+    do {
+      try self.__implementation.updateLiveActivity(status: String(status), statusText: String(statusText), estimatedMinutes: estimatedMinutes, distanceMeters: distanceMeters)
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func endLiveActivity() -> bridge.Result_void_ {
+    do {
+      try self.__implementation.endLiveActivity()
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func destroy() -> bridge.Result_void_ {
     do {

package/nitrogen/generated/shared/c++/HybridNitroLocationTrackingSpec.cpp

@@ -55,6 +55,9 @@ namespace margelo::nitro::nitrolocationtracking {
       prototype.registerHybridMethod("getDistanceToGeofence", &HybridNitroLocationTrackingSpec::getDistanceToGeofence);
       prototype.registerHybridMethod("showLocalNotification", &HybridNitroLocationTrackingSpec::showLocalNotification);
       prototype.registerHybridMethod("updateForegroundNotification", &HybridNitroLocationTrackingSpec::updateForegroundNotification);
+      prototype.registerHybridMethod("startLiveActivity", &HybridNitroLocationTrackingSpec::startLiveActivity);
+      prototype.registerHybridMethod("updateLiveActivity", &HybridNitroLocationTrackingSpec::updateLiveActivity);
+      prototype.registerHybridMethod("endLiveActivity", &HybridNitroLocationTrackingSpec::endLiveActivity);
       prototype.registerHybridMethod("destroy", &HybridNitroLocationTrackingSpec::destroy);
     });
   }

package/nitrogen/generated/shared/c++/HybridNitroLocationTrackingSpec.hpp

@@ -123,6 +123,9 @@ namespace margelo::nitro::nitrolocationtracking {
       virtual double getDistanceToGeofence(const std::string& regionId) = 0;
       virtual void showLocalNotification(const std::string& title, const std::string& body) = 0;
       virtual void updateForegroundNotification(const std::string& title, const std::string& body) = 0;
+      virtual void startLiveActivity(const std::string& orderId, const std::string& customerName, const std::string& deliveryAddress, double orderCount, const std::string& status, const std::string& statusText, double estimatedMinutes, double distanceMeters) = 0;
+      virtual void updateLiveActivity(const std::string& status, const std::string& statusText, double estimatedMinutes, double distanceMeters) = 0;
+      virtual void endLiveActivity() = 0;
       virtual void destroy() = 0;
 
     protected:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-location-tracking",
-  "version": "0.1.18",
+  "version": "0.1.21",
   "description": "A React Native Nitro module for location tracking",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/NitroLocationTracking.nitro.ts

@@ -182,6 +182,25 @@ export interface NitroLocationTracking
   showLocalNotification(title: string, body: string): void;
   updateForegroundNotification(title: string, body: string): void;
 
+  // === Live Activity (iOS Dynamic Island / Lock Screen) ===
+  startLiveActivity(
+    orderId: string,
+    customerName: string,
+    deliveryAddress: string,
+    orderCount: number,
+    status: string,
+    statusText: string,
+    estimatedMinutes: number,
+    distanceMeters: number
+  ): void;
+  updateLiveActivity(
+    status: string,
+    statusText: string,
+    estimatedMinutes: number,
+    distanceMeters: number
+  ): void;
+  endLiveActivity(): void;
+
   // === Lifecycle ===
   destroy(): void;
 }

package/src/index.tsx

@@ -1,4 +1,5 @@
 import { useState, useEffect, useCallback, useRef } from 'react';
+import { Platform } from 'react-native';
 import { NitroModules } from 'react-native-nitro-modules';
 import type {
   NitroLocationTracking,
@@ -17,6 +18,21 @@ export const NitroLocationCalculations = NitroModules.createHybridObject<
 >('NitroLocationComplexLogicsCalculation');
 
 export default NitroLocationModule;
+
+// Live Activities are an iOS-only feature (Android calls are safe no-ops).
+// Use this guard before calling startLiveActivity / updateLiveActivity / endLiveActivity.
+export function isLiveActivitySupported(): boolean {
+  return Platform.OS === 'ios';
+}
+
+// Convenience type for the mutable state passed to startLiveActivity / updateLiveActivity.
+export type LiveActivityState = {
+  status: 'picking_up' | 'on_the_way' | 'arriving' | 'delivered';
+  statusText: string;
+  estimatedMinutes: number;
+  distanceMeters: number;
+};
+
 export { requestLocationPermission } from './requestPermission';
 export { LocationSmoother } from './LocationSmoother';
 export { shortestRotation, calculateBearing } from './bearing';