expo-live-activity 0.2.0-alpha2 → 0.2.0-alpha4

package/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]  
+> This library is in early development stage, breaking changes can be introduced in minor version upgrades.
+
 # expo-live-activity
 
 `expo-live-activity` is a React Native module designed for use with Expo to manage and display live activities on iOS devices exclusively. This module leverages the Live Activities feature introduced in iOS 16, allowing developers to deliver timely updates right on the lock screen.
@@ -6,6 +9,7 @@
 - Start, update, and stop live activities directly from your React Native application.
 - Easy integration with a comprehensive API.
 - Custom image support within live activities with a pre-configured path.
+- Listen and handle changes in push notification tokens associated with a live activity.
 
 ## Platform compatibility
 **Note:** This module is intended for use on **iOS devices only**. When methods are invoked on platforms other than iOS, they will throw an error, ensuring that they are used in the correct context.
@@ -38,18 +42,54 @@ Import the functionalities provided by the `expo-live-activity` module in your J
 import * as LiveActivity from "expo-live-activity";
 ```
 
+## Push notifications
+By default, updating live activity is possible only via API. There is also a way to update live activity using push notifications. To enable that feature, add `"enablePushNotifications": true`. Then, the notification payload should be looking like this:
+
+```json
+{
+    "aps":{
+        "event":"update",
+        "content-state":{
+            "title":"Hello",
+            "subtitle":"World",
+            "date":1754064245000
+        },
+        "timestamp":1754063621319
+    }
+}
+```
+
+Where `date` value is a timestamp in milliseconds corresponding to the target point of the counter displayed in live activity view.
+
+## Image support
+Live activity view also supports image display. There are two dedicated fields for that:
+- `imageName`
+- `dynamicIslandImageName`
+Currently, it's possible to set them only via API, but we plan on to add that feature to push notifications as well. The value of each field can be:
+- a string which maps to an asset name
+- a URL to remote image
+The latter requires adding "App Groups" capability to both "main app" and "live activity" targets.
+
 ## API
 `expo-live-activity` module exports three primary functions to manage live activities:
 
-- **`startActivity(state, styles)`**:
-  Start a new live activity. Takes a `state` configuration object for initial activity state and an optional `styles` object to customize appearance. It returns the `ID` of the created live activity, which should be stored for future reference.
+### Managing Live Activities
+- **`startActivity(state: LiveActivityState, config?: LiveActivityConfig)`**:
+  Start a new live activity. Takes a `state` configuration object for initial activity state and an optional `config` object to customize appearance or behavior. It returns the `ID` of the created live activity, which should be stored for future reference.
 
-- **`updateActivity(activityId, state)`**:
+- **`updateActivity(id: string, state: LiveActivityState)`**:
   Update an existing live activity. The `state` object should contain updated information. The `activityId` indicates which activity should be updated.
 
-- **`stopActivity(activityId, state)`**:
+- **`stopActivity(id: string, state: LiveActivityState)`**:
   Terminate an ongoing live activity. The `state` object should contain the final state of the activity. The `activityId` indicates which activity should be stopped.
 
+### Handling Push Notification Tokens
+- **`addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription)`**:
+  Subscribe to changes in the push notification token associated with live activities.
+
+### Deep linking
+When starting a new live activity, it's possible to pass `deepLinkUrl` field in `config` object. This can be any string that you can handle in your main app target. 
+
 ### State Object Structure
 The `state` object should include:
 ```javascript
@@ -62,8 +102,8 @@ The `state` object should include:
 };
 ```
 
-### Styles Object Structure
-The `styles` object should include:
+### Config Object Structure
+The `config` object should include:
 ```typescript
 {
    backgroundColor?: string;
@@ -71,11 +111,13 @@ The `styles` object should include:
    subtitleColor?: string;
    progressViewTint?: string;
    progressViewLabelColor?: string;
+   deepLinkUrl?: string;
    timerType?: DynamicIslandTimerType; // "circular" | "digital" - defines timer appereance on the dynamic island
 };
 ```
 
 ## Example Usage
+Managing a live activity:
 ```javascript
 const state = {
   title: "Title",
@@ -85,16 +127,31 @@ const state = {
   dynamicIslandImageName: "dynamic_island_image"
 };
 
-const styles = {
+const config = {
   backgroundColor: "#FFFFFF",
   titleColor: "#000000",
   subtitleColor: "#333333",
   progressViewTint: "#4CAF50",
   progressViewLabelColor: "#FFFFFF",
+  deepLinkUrl: "/dashboard",
   timerType: "circular"
 };
 
-const activityId = LiveActivity.startActivity(state, styles);
+const activityId = LiveActivity.startActivity(state, config);
 // Store activityId for future reference
 ```
 This will initiate a live activity with the specified title, subtitle, image from your configured assets folder and a time to which there will be a countdown in a progress view.
+
+Subscribing to push token changes:
+```javascript
+useEffect(() => {
+  const subscription = LiveActivity.addActivityTokenListener(({ 
+    activityID: newActivityID,
+    activityPushToken: newToken
+  }) => {
+    // Send token to a remote server to update live activity with push notifications
+  });
+
+  return () => subscription.remove();
+}, []);
+```

package/build/index.d.ts

@@ -1,3 +1,4 @@
+import { EventSubscription } from 'expo-modules-core';
 export type DynamicIslandTimerType = 'circular' | 'digital';
 export type LiveActivityState = {
     title: string;
@@ -6,32 +7,40 @@ export type LiveActivityState = {
     imageName?: string;
     dynamicIslandImageName?: string;
 };
-export type LiveActivityStyles = {
+export type LiveActivityConfig = {
     backgroundColor?: string;
     titleColor?: string;
     subtitleColor?: string;
     progressViewTint?: string;
     progressViewLabelColor?: string;
-    timerType: DynamicIslandTimerType;
+    deepLinkUrl?: string;
+    timerType?: DynamicIslandTimerType;
+};
+export type ActivityTokenReceivedEvent = {
+    activityID: string;
+    activityPushToken: string;
+};
+export type LiveActivityModuleEvents = {
+    onTokenReceived: (params: ActivityTokenReceivedEvent) => void;
 };
 /**
  * @param {LiveActivityState} state The state for the live activity.
+ * @param {LiveActivityConfig} config Live activity config object.
  * @returns {string} The identifier of the started activity.
- * @throws {Error} When function is called on platform different than iOS.
+ * @throws {Error} When function is called on a platform different from iOS.
  */
-export declare function startActivity(state: LiveActivityState, styles?: LiveActivityStyles): string;
+export declare function startActivity(state: LiveActivityState, config?: LiveActivityConfig): string;
 /**
  * @param {string} id The identifier of the activity to stop.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @returns {string} The identifier of the stopped activity.
- * @throws {Error} When function is called on platform different than iOS.
+ * @throws {Error} When function is called on a platform different from iOS.
  */
-export declare function stopActivity(id: string, state: LiveActivityState): string;
+export declare function stopActivity(id: string, state: LiveActivityState): any;
 /**
  * @param {string} id The identifier of the activity to update.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @returns {string} The identifier of the updated activity.
- * @throws {Error} When function is called on platform different than iOS.
+ * @throws {Error} When function is called on a platform different from iOS.
  */
-export declare function updateActivity(id: string, state: LiveActivityState): string;
+export declare function updateActivity(id: string, state: LiveActivityState): any;
+export declare function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription;
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAA;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE,sBAAsB,CAAC;CACnC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAK3F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAK3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAA;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAK3F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAKhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAKlE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAAG,iBAAiB,CAKjH"}

package/build/index.js

@@ -2,20 +2,20 @@ import ExpoLiveActivityModule from "./ExpoLiveActivityModule";
 import { Platform } from "react-native";
 /**
  * @param {LiveActivityState} state The state for the live activity.
+ * @param {LiveActivityConfig} config Live activity config object.
  * @returns {string} The identifier of the started activity.
- * @throws {Error} When function is called on platform different than iOS.
+ * @throws {Error} When function is called on a platform different from iOS.
  */
-export function startActivity(state, styles) {
+export function startActivity(state, config) {
     if (Platform.OS !== "ios") {
         throw new Error("startActivity is only available on iOS");
     }
-    return ExpoLiveActivityModule.startActivity(state, styles);
+    return ExpoLiveActivityModule.startActivity(state, config);
 }
 /**
  * @param {string} id The identifier of the activity to stop.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @returns {string} The identifier of the stopped activity.
- * @throws {Error} When function is called on platform different than iOS.
+ * @throws {Error} When function is called on a platform different from iOS.
  */
 export function stopActivity(id, state) {
     if (Platform.OS !== "ios") {
@@ -26,8 +26,7 @@ export function stopActivity(id, state) {
 /**
  * @param {string} id The identifier of the activity to update.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @returns {string} The identifier of the updated activity.
- * @throws {Error} When function is called on platform different than iOS.
+ * @throws {Error} When function is called on a platform different from iOS.
  */
 export function updateActivity(id, state) {
     if (Platform.OS !== "ios") {
@@ -35,4 +34,10 @@ export function updateActivity(id, state) {
     }
     return ExpoLiveActivityModule.updateActivity(id, state);
 }
+export function addActivityTokenListener(listener) {
+    if (Platform.OS !== "ios") {
+        throw new Error("updateActivity is only available on iOS");
+    }
+    return ExpoLiveActivityModule.addListener('onTokenReceived', listener);
+}
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAqBxC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,MAA2B;IACjF,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,sBAAsB,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,KAAwB;IAC/D,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,sBAAsB,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,KAAwB;IACjE,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,sBAAsB,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["import ExpoLiveActivityModule from \"./ExpoLiveActivityModule\";\nimport { Platform } from \"react-native\";\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\nexport type LiveActivityState = {\n  title: string;\n  subtitle?: string;\n  date?: number;\n  imageName?: string;\n  dynamicIslandImageName?: string;\n};\n\nexport type LiveActivityStyles = {\n  backgroundColor?: string;\n  titleColor?: string;\n  subtitleColor?: string;\n  progressViewTint?: string;\n  progressViewLabelColor?: string;\n  timerType: DynamicIslandTimerType;\n};\n\n/**\n * @param {LiveActivityState} state The state for the live activity.\n * @returns {string} The identifier of the started activity.\n * @throws {Error} When function is called on platform different than iOS.\n */\nexport function startActivity(state: LiveActivityState, styles?: LiveActivityStyles): string {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"startActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.startActivity(state, styles);\n}\n\n/**\n * @param {string} id The identifier of the activity to stop.\n * @param {LiveActivityState} state The updated state for the live activity.\n * @returns {string} The identifier of the stopped activity.\n * @throws {Error} When function is called on platform different than iOS.\n */\nexport function stopActivity(id: string, state: LiveActivityState): string {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"stopActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.stopActivity(id, state);\n}\n\n/**\n * @param {string} id The identifier of the activity to update.\n * @param {LiveActivityState} state The updated state for the live activity.\n * @returns {string} The identifier of the updated activity.\n * @throws {Error} When function is called on platform different than iOS.\n */\nexport function updateActivity(id: string, state: LiveActivityState): string {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"updateActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.updateActivity(id, state);\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAgCxC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,MAA2B;IACjF,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,sBAAsB,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,KAAwB;IAC/D,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,sBAAsB,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,KAAwB;IACjE,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,sBAAsB,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAqD;IAC5F,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,sBAAsB,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AACzE,CAAC","sourcesContent":["import ExpoLiveActivityModule from \"./ExpoLiveActivityModule\";\nimport { Platform } from \"react-native\";\nimport { EventSubscription } from 'expo-modules-core';\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\nexport type LiveActivityState = {\n  title: string;\n  subtitle?: string;\n  date?: number;\n  imageName?: string;\n  dynamicIslandImageName?: string;\n};\n\nexport type LiveActivityConfig = {\n  backgroundColor?: string;\n  titleColor?: string;\n  subtitleColor?: string;\n  progressViewTint?: string;\n  progressViewLabelColor?: string;\n  deepLinkUrl?: string;\n  timerType?: DynamicIslandTimerType;\n};\n\nexport type ActivityTokenReceivedEvent = {\n  activityID: string;\n  activityPushToken: string;\n};\n\nexport type LiveActivityModuleEvents = {\n  onTokenReceived: (params: ActivityTokenReceivedEvent) => void;\n};\n\n/**\n * @param {LiveActivityState} state The state for the live activity.\n * @param {LiveActivityConfig} config Live activity config object.\n * @returns {string} The identifier of the started activity.\n * @throws {Error} When function is called on a platform different from iOS.\n */\nexport function startActivity(state: LiveActivityState, config?: LiveActivityConfig): string {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"startActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.startActivity(state, config);\n}\n\n/**\n * @param {string} id The identifier of the activity to stop.\n * @param {LiveActivityState} state The updated state for the live activity.\n * @throws {Error} When function is called on a platform different from iOS.\n */\nexport function stopActivity(id: string, state: LiveActivityState) {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"stopActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.stopActivity(id, state);\n}\n\n/**\n * @param {string} id The identifier of the activity to update.\n * @param {LiveActivityState} state The updated state for the live activity.\n * @throws {Error} When function is called on a platform different from iOS.\n */\nexport function updateActivity(id: string, state: LiveActivityState) {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"updateActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.updateActivity(id, state);\n}\n\nexport function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"updateActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.addListener('onTokenReceived', listener);\n}\n"]}

package/ios/Data+download.swift

@@ -0,0 +1,13 @@
+//
+//  Data+download.swift
+//  
+//
+//  Created by Artur Bilski on 04/08/2025.
+//
+
+extension Data {
+  static func download(from url: URL) async throws -> Self {
+    let (data, _) = try await URLSession.shared.data(from: url)
+    return data
+  }
+}

package/ios/ExpoLiveActivityModule.swift

@@ -2,139 +2,190 @@ import ActivityKit
 import ExpoModulesCore
 
 enum ModuleErrors: Error {
-    case unsupported
-    case liveActivitiesNotEnabled
+  case unsupported
+  case liveActivitiesNotEnabled
 }
 
 public class ExpoLiveActivityModule: Module {
-    struct LiveActivityState: Record {
-        @Field
-        var title: String
+  struct LiveActivityState: Record {
+    @Field
+    var title: String
 
-        @Field
-        var subtitle: String?
+    @Field
+    var subtitle: String?
 
-        @Field
-        var date: Double?
+    @Field
+    var date: Double?
 
-        @Field
-        var imageName: String?
+    @Field
+    var imageName: String?
 
-        @Field
-        var dynamicIslandImageName: String?
-    }
+    @Field
+    var dynamicIslandImageName: String?
+  }
+
+  struct LiveActivityConfig: Record {
+    @Field
+    var backgroundColor: String?
+
+    @Field
+    var titleColor: String?
+
+    @Field
+    var subtitleColor: String?
+
+    @Field
+    var progressViewTint: String?
+
+    @Field
+    var progressViewLabelColor: String?
     
-    struct LiveActivityStyles: Record {
-        @Field
-        var backgroundColor: String?
-        
-        @Field
-        var titleColor: String?
-        
-        @Field
-        var subtitleColor: String?
-        
-        @Field
-        var progressViewTint: String?
-        
-        @Field
-        var progressViewLabelColor: String?
-        
-        @Field
-        var timerType: DynamicIslandTimerType?
+    @Field
+    var deepLinkUrl: String?
+
+    @Field
+    var timerType: DynamicIslandTimerType?
+  }
+
+  enum DynamicIslandTimerType: String, Enumerable {
+    case circular
+    case digital
+  }
+
+  func sendPushToken(activityID: String, activityPushToken: String) {
+    sendEvent(
+      "onTokenReceived",
+      [
+        "activityID": activityID,
+        "activityPushToken": activityPushToken,
+      ]
+    )
+  }
+
+  func toContentStateDate(date: Double?) -> Date? {
+    return date.map { Date(timeIntervalSince1970: $0 / 1000) }
+  }
+
+  func updateImages(state: LiveActivityState, newState: inout LiveActivityAttributes.ContentState) async throws {
+    if let name = state.imageName {
+      print("imageName: \(name)")
+      newState.imageName = try await resolveImage(from: name)
     }
-    
-    enum DynamicIslandTimerType: String, Enumerable {
-        case circular
-        case digital
+
+    if let name = state.dynamicIslandImageName {
+      print("dynamicIslandImageName: \(name)")
+      newState.dynamicIslandImageName = try await resolveImage(from: name)
     }
+  }
+
+  public func definition() -> ModuleDefinition {
+    Name("ExpoLiveActivity")
+
+    Events("onTokenReceived")
 
-    public func definition() -> ModuleDefinition {
-        Name("ExpoLiveActivity")
-
-        Function("startActivity") { (state: LiveActivityState, styles: LiveActivityStyles? ) -> String in
-            let date = state.date != nil ? Date(timeIntervalSince1970: state.date! / 1000) : nil
-            print("Starting activity")
-            if #available(iOS 16.2, *) {
-                if ActivityAuthorizationInfo().areActivitiesEnabled {
-                    do {
-                        let counterState = LiveActivityAttributes(
-                            name: "ExpoLiveActivity",
-                            backgroundColor: styles?.backgroundColor,
-                            titleColor: styles?.titleColor,
-                            subtitleColor: styles?.subtitleColor,
-                            progressViewTint: styles?.progressViewTint,
-                            progressViewLabelColor: styles?.progressViewLabelColor,
-                            timerType: styles?.timerType == .digital ? .digital : .circular
-                        )
-                        let initialState = LiveActivityAttributes.ContentState(
-                            title: state.title,
-                            subtitle: state.subtitle,
-                            date: date,
-                            imageName: state.imageName,
-                            dynamicIslandImageName: state.dynamicIslandImageName)
-                        let activity = try Activity.request(
-                            attributes: counterState,
-                            content: .init(state: initialState, staleDate: nil), pushType: nil)
-                        return activity.id
-                    } catch (let error) {
-                        print("Error with live activity: \(error)")
-                    }
-                }
-                throw ModuleErrors.liveActivitiesNotEnabled
-            } else {
-                throw ModuleErrors.unsupported
+    Function("startActivity") { (state: LiveActivityState, maybeConfig: LiveActivityConfig?) -> String in
+      print("Starting activity")
+      if #available(iOS 16.2, *) {
+        if ActivityAuthorizationInfo().areActivitiesEnabled {
+          do {
+            let config = maybeConfig ?? LiveActivityConfig()
+            let attributes = LiveActivityAttributes(
+              name: "ExpoLiveActivity",
+              backgroundColor: config.backgroundColor,
+              titleColor: config.titleColor,
+              subtitleColor: config.subtitleColor,
+              progressViewTint: config.progressViewTint,
+              progressViewLabelColor: config.progressViewLabelColor,
+              deepLinkUrl: config.deepLinkUrl,
+              timerType: config.timerType == .digital ? .digital : .circular
+            )
+            let initialState = LiveActivityAttributes.ContentState(
+              title: state.title,
+              subtitle: state.subtitle,
+              date: toContentStateDate(date: state.date),
+            )
+            let pushNotificationsEnabled =
+              Bundle.main.object(forInfoDictionaryKey: "ExpoLiveActivity_EnablePushNotifications") as? Bool
+            let activity = try Activity.request(
+              attributes: attributes,
+              content: .init(state: initialState, staleDate: nil),
+              pushType: pushNotificationsEnabled == true ? .token : nil
+            )
+
+            Task {
+              for await pushToken in activity.pushTokenUpdates {
+                let pushTokenString = pushToken.reduce("") { $0 + String(format: "%02x", $1) }
+
+                sendPushToken(activityID: activity.id, activityPushToken: pushTokenString)
+              }
             }
-        }
 
-        Function("stopActivity") { (activityId: String, state: LiveActivityState) -> Void in
-            if #available(iOS 16.2, *) {
-                print("Attempting to stop")
-                let endState = LiveActivityAttributes.ContentState(
-                    title: state.title,
-                    subtitle: state.subtitle,
-                    date: state.date != nil ? Date(timeIntervalSince1970: state.date! / 1000) : nil,
-                    imageName: state.imageName,
-                    dynamicIslandImageName: state.dynamicIslandImageName)
-                if let activity = Activity<LiveActivityAttributes>.activities.first(where: {
-                    $0.id == activityId
-                }) {
-                    Task {
-                        print("Stopping activity with id: \(activityId)")
-                        await activity.end(
-                            ActivityContent(state: endState, staleDate: nil),
-                            dismissalPolicy: .immediate)
-                    }
-                } else {
-                    print("Didn't find activity with ID \(activityId)")
-                }
-            } else {
-                throw ModuleErrors.unsupported
+            Task {
+              var newState = activity.content.state
+              try await updateImages(state: state, newState: &newState)
+              await activity.update(ActivityContent(state: newState, staleDate: nil))
             }
+
+            return activity.id
+          } catch (let error) {
+            print("Error with live activity: \(error)")
+          }
         }
+        throw ModuleErrors.liveActivitiesNotEnabled
+      } else {
+        throw ModuleErrors.unsupported
+      }
+    }
 
-        Function("updateActivity") { (activityId: String, state: LiveActivityState) -> Void in
-            if #available(iOS 16.2, *) {
-                print("Attempting to update")
-                let newState = LiveActivityAttributes.ContentState(
-                    title: state.title,
-                    subtitle: state.subtitle,
-                    date: state.date != nil ? Date(timeIntervalSince1970: state.date! / 1000) : nil,
-                    imageName: state.imageName,
-                    dynamicIslandImageName: state.dynamicIslandImageName)
-                if let activity = Activity<LiveActivityAttributes>.activities.first(where: {
-                    $0.id == activityId
-                }) {
-                    Task {
-                        print("Updating activity with id: \(activityId)")
-                        await activity.update(ActivityContent(state: newState, staleDate: nil))
-                    }
-                } else {
-                    print("Didn't find activity with ID \(activityId)")
-                }
-            } else {
-                throw ModuleErrors.unsupported
-            }
+    Function("stopActivity") { (activityId: String, state: LiveActivityState) -> Void in
+      if #available(iOS 16.2, *) {
+        print("Attempting to stop")
+        var newState = LiveActivityAttributes.ContentState(
+          title: state.title,
+          subtitle: state.subtitle,
+          date: toContentStateDate(date: state.date),
+        )
+        if let activity = Activity<LiveActivityAttributes>.activities.first(where: {
+          $0.id == activityId
+        }) {
+          Task {
+            print("Stopping activity with id: \(activityId)")
+            try await updateImages(state: state, newState: &newState)
+            await activity.end(
+              ActivityContent(state: newState, staleDate: nil),
+              dismissalPolicy: .immediate
+            )
+          }
+        } else {
+          print("Didn't find activity with ID \(activityId)")
+        }
+      } else {
+        throw ModuleErrors.unsupported
+      }
+    }
+
+    Function("updateActivity") { (activityId: String, state: LiveActivityState) -> Void in
+      if #available(iOS 16.2, *) {
+        print("Attempting to update")
+        var newState = LiveActivityAttributes.ContentState(
+          title: state.title,
+          subtitle: state.subtitle,
+          date: toContentStateDate(date: state.date),
+        )
+        if let activity = Activity<LiveActivityAttributes>.activities.first(where: {
+          $0.id == activityId
+        }) {
+          Task {
+            print("Updating activity with id: \(activityId)")
+            try await updateImages(state: state, newState: &newState)
+            await activity.update(ActivityContent(state: newState, staleDate: nil))
+          }
+        } else {
+          print("Didn't find activity with ID \(activityId)")
         }
+      } else {
+        throw ModuleErrors.unsupported
+      }
     }
+  }
 }

package/ios/Helpers.swift

@@ -0,0 +1,22 @@
+//
+//  Helpers.swift
+//  
+//
+//  Created by Artur Bilski on 04/08/2025.
+//
+
+func resolveImage(from string: String) async throws -> String {
+  if let url = URL(string: string), url.scheme?.hasPrefix("http") == true,
+    let container = FileManager.default.containerURL(
+      forSecurityApplicationGroupIdentifier: "group.expoLiveActivity.sharedData"
+    )
+  {
+    let data = try await Data.download(from: url)
+    let filename = UUID().uuidString + ".png"
+    let fileURL = container.appendingPathComponent(filename)
+    try data.write(to: fileURL)
+    return fileURL.lastPathComponent
+  } else {
+    return string
+  }
+}

package/ios/LiveActivityAttributes.swift

@@ -5,8 +5,8 @@
 //  Created by Anna Olak on 03/06/2025.
 //
 
-import Foundation
 import ActivityKit
+import Foundation
 
 struct LiveActivityAttributes: ActivityAttributes {
   public struct ContentState: Codable, Hashable {
@@ -23,10 +23,11 @@ struct LiveActivityAttributes: ActivityAttributes {
   var subtitleColor: String?
   var progressViewTint: String?
   var progressViewLabelColor: String?
+  var deepLinkUrl: String?
   var timerType: DynamicIslandTimerType
-  
+
   enum DynamicIslandTimerType: String, Codable {
-      case circular
-      case digital
+    case circular
+    case digital
   }
 }