expo-live-activity 0.2.0-alpha3 → 0.2.0-alpha4

package/README.md

@@ -74,8 +74,8 @@ The latter requires adding "App Groups" capability to both "main app" and "live
 `expo-live-activity` module exports three primary functions to manage live activities:
 
 ### Managing Live Activities
-- **`startActivity(state: LiveActivityState, styles?: LiveActivityStyles)`**:
-  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.
+- **`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(id: string, state: LiveActivityState)`**:
   Update an existing live activity. The `state` object should contain updated information. The `activityId` indicates which activity should be updated.
@@ -87,6 +87,9 @@ The latter requires adding "App Groups" capability to both "main app" and "live
 - **`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
@@ -99,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;
@@ -108,6 +111,7 @@ The `styles` object should include:
    subtitleColor?: string;
    progressViewTint?: string;
    progressViewLabelColor?: string;
+   deepLinkUrl?: string;
    timerType?: DynamicIslandTimerType; // "circular" | "digital" - defines timer appereance on the dynamic island
 };
 ```
@@ -123,16 +127,17 @@ 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.

package/build/index.d.ts

@@ -7,12 +7,13 @@ export type LiveActivityState = {
     imageName?: string;
     dynamicIslandImageName?: string;
 };
-export type LiveActivityStyles = {
+export type LiveActivityConfig = {
     backgroundColor?: string;
     titleColor?: string;
     subtitleColor?: string;
     progressViewTint?: string;
     progressViewLabelColor?: string;
+    deepLinkUrl?: string;
     timerType?: DynamicIslandTimerType;
 };
 export type ActivityTokenReceivedEvent = {
@@ -24,11 +25,11 @@ export type LiveActivityModuleEvents = {
 };
 /**
  * @param {LiveActivityState} state The state for the live activity.
- * @param {LiveActivityStyles} styles Live activity styling object.
+ * @param {LiveActivityConfig} config Live activity config object.
  * @returns {string} The identifier of the started activity.
  * @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.

package/build/index.d.ts.map

@@ -1 +1 @@
-{"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,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"}
+{"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,15 +2,15 @@ import ExpoLiveActivityModule from "./ExpoLiveActivityModule";
 import { Platform } from "react-native";
 /**
  * @param {LiveActivityState} state The state for the live activity.
- * @param {LiveActivityStyles} styles Live activity styling object.
+ * @param {LiveActivityConfig} config Live activity config object.
  * @returns {string} The identifier of the started activity.
  * @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.

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;AA+BxC;;;;;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 LiveActivityStyles = {\n  backgroundColor?: string;\n  titleColor?: string;\n  subtitleColor?: string;\n  progressViewTint?: string;\n  progressViewLabelColor?: 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 {LiveActivityStyles} styles Live activity styling 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, 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 * @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"]}
+{"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/ExpoLiveActivityModule.swift

@@ -24,7 +24,7 @@ public class ExpoLiveActivityModule: Module {
     var dynamicIslandImageName: String?
   }
 
-  struct LiveActivityStyles: Record {
+  struct LiveActivityConfig: Record {
     @Field
     var backgroundColor: String?
 
@@ -39,6 +39,9 @@ public class ExpoLiveActivityModule: Module {
 
     @Field
     var progressViewLabelColor: String?
+    
+    @Field
+    var deepLinkUrl: String?
 
     @Field
     var timerType: DynamicIslandTimerType?
@@ -80,19 +83,21 @@ public class ExpoLiveActivityModule: Module {
 
     Events("onTokenReceived")
 
-    Function("startActivity") { (state: LiveActivityState, styles: LiveActivityStyles?) -> String in
+    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: styles?.backgroundColor,
-              titleColor: styles?.titleColor,
-              subtitleColor: styles?.subtitleColor,
-              progressViewTint: styles?.progressViewTint,
-              progressViewLabelColor: styles?.progressViewLabelColor,
-              timerType: styles?.timerType == .digital ? .digital : .circular
+              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,
@@ -100,11 +105,11 @@ public class ExpoLiveActivityModule: Module {
               date: toContentStateDate(date: state.date),
             )
             let pushNotificationsEnabled =
-              Bundle.main.object(forInfoDictionaryKey: "ExpoLiveActivity_EnablePushNotifications")
+              Bundle.main.object(forInfoDictionaryKey: "ExpoLiveActivity_EnablePushNotifications") as? Bool
             let activity = try Activity.request(
               attributes: attributes,
               content: .init(state: initialState, staleDate: nil),
-              pushType: pushNotificationsEnabled == nil ? nil : .token
+              pushType: pushNotificationsEnabled == true ? .token : nil
             )
 
             Task {

package/ios/LiveActivityAttributes.swift

@@ -23,6 +23,7 @@ struct LiveActivityAttributes: ActivityAttributes {
   var subtitleColor: String?
   var progressViewTint: String?
   var progressViewLabelColor: String?
+  var deepLinkUrl: String?
   var timerType: DynamicIslandTimerType
 
   enum DynamicIslandTimerType: String, Codable {

package/ios-files/LiveActivityWidget.swift

@@ -24,6 +24,7 @@ struct LiveActivityAttributes: ActivityAttributes {
   var subtitleColor: String?
   var progressViewTint: String?
   var progressViewLabelColor: String?
+  var deepLinkUrl: String?
   var timerType: DynamicIslandTimerType
 
   enum DynamicIslandTimerType: String, Codable {
@@ -37,33 +38,37 @@ struct LiveActivityWidget: Widget {
     ActivityConfiguration(for: LiveActivityAttributes.self) { context in
       LiveActivityView(contentState: context.state, attributes: context.attributes)
         .activityBackgroundTint(
-          context.attributes.backgroundColor != nil ? Color(hex: context.attributes.backgroundColor!) : nil
+          context.attributes.backgroundColor.map { Color(hex: $0) }
         )
         .activitySystemActionForegroundColor(Color.black)
-
+        .applyWidgetURL(from: context.attributes.deepLinkUrl)
     } dynamicIsland: { context in
       DynamicIsland {
         DynamicIslandExpandedRegion(.leading, priority: 1) {
           dynamicIslandExpandedLeading(title: context.state.title, subtitle: context.state.subtitle)
             .dynamicIsland(verticalPlacement: .belowIfTooWide)
             .padding(.leading, 5)
+            .applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
         DynamicIslandExpandedRegion(.trailing) {
           if let imageName = context.state.imageName {
             dynamicIslandExpandedTrailing(imageName: imageName)
               .padding(.trailing, 5)
+              .applyWidgetURL(from: context.attributes.deepLinkUrl)
           }
         }
         DynamicIslandExpandedRegion(.bottom) {
           if let date = context.state.date {
             dynamicIslandExpandedBottom(endDate: date, progressViewTint: context.attributes.progressViewTint)
               .padding(.horizontal, 5)
+              .applyWidgetURL(from: context.attributes.deepLinkUrl)
           }
         }
       } compactLeading: {
         if let dynamicIslandImageName = context.state.dynamicIslandImageName {
           resizableImage(imageName: dynamicIslandImageName)
             .frame(maxWidth: 23, maxHeight: 23)
+            .applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       } compactTrailing: {
         if let date = context.state.date {
@@ -71,7 +76,7 @@ struct LiveActivityWidget: Widget {
             endDate: date,
             timerType: context.attributes.timerType,
             progressViewTint: context.attributes.progressViewTint
-          )
+          ).applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       } minimal: {
         if let date = context.state.date {
@@ -79,7 +84,7 @@ struct LiveActivityWidget: Widget {
             endDate: date,
             timerType: context.attributes.timerType,
             progressViewTint: context.attributes.progressViewTint
-          )
+          ).applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       }
     }
@@ -100,7 +105,7 @@ struct LiveActivityWidget: Widget {
         .multilineTextAlignment(.trailing)
     } else {
       circularTimer(endDate: endDate)
-        .tint(progressViewTint != nil ? Color(hex: progressViewTint!) : nil)
+        .tint(progressViewTint.map { Color(hex: $0) })
     }
   }
 
@@ -133,7 +138,7 @@ struct LiveActivityWidget: Widget {
   private func dynamicIslandExpandedBottom(endDate: Double, progressViewTint: String?) -> some View {
     ProgressView(timerInterval: Date.toTimerInterval(miliseconds: endDate))
       .foregroundStyle(.white)
-      .tint(progressViewTint != nil ? Color(hex: progressViewTint!) : nil)
+      .tint(progressViewTint.map { Color(hex: $0) })
       .padding(.top, 5)
   }
 

package/ios-files/View+applyIfPresent.swift

@@ -0,0 +1,19 @@
+//
+//  View+applyIfPresent.swift
+//
+//
+//  Created by Artur Bilski on 05/08/2025.
+//
+
+import SwiftUI
+
+extension View {
+  @ViewBuilder
+  func applyIfPresent<T>(_ value: T?, transform: (Self, T) -> some View) -> some View {
+    if let value {
+      transform(self, value)
+    } else {
+      self
+    }
+  }
+}

package/ios-files/View+applyWidgetURL.swift

@@ -0,0 +1,15 @@
+//
+//  View+applyWidgetURL.swift
+//
+//
+//  Created by Artur Bilski on 05/08/2025.
+//
+
+import SwiftUI
+
+extension View {
+  @ViewBuilder
+  func applyWidgetURL(from urlString: String?) -> some View {
+    applyIfPresent(urlString) { view, string in view.widgetURL(URL(string: string))}
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-live-activity",
-  "version": "0.2.0-alpha3",
+  "version": "0.2.0-alpha4",
   "description": "A module for adding Live Activity to a React Native app for iOS.",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/src/index.ts

@@ -12,12 +12,13 @@ export type LiveActivityState = {
   dynamicIslandImageName?: string;
 };
 
-export type LiveActivityStyles = {
+export type LiveActivityConfig = {
   backgroundColor?: string;
   titleColor?: string;
   subtitleColor?: string;
   progressViewTint?: string;
   progressViewLabelColor?: string;
+  deepLinkUrl?: string;
   timerType?: DynamicIslandTimerType;
 };
 
@@ -32,15 +33,15 @@ export type LiveActivityModuleEvents = {
 
 /**
  * @param {LiveActivityState} state The state for the live activity.
- * @param {LiveActivityStyles} styles Live activity styling object.
+ * @param {LiveActivityConfig} config Live activity config object.
  * @returns {string} The identifier of the started activity.
  * @throws {Error} When function is called on a platform different from iOS.
  */
-export function startActivity(state: LiveActivityState, styles?: LiveActivityStyles): string {
+export function startActivity(state: LiveActivityState, config?: LiveActivityConfig): string {
   if (Platform.OS !== "ios") {
     throw new Error("startActivity is only available on iOS");
   }
-  return ExpoLiveActivityModule.startActivity(state, styles);
+  return ExpoLiveActivityModule.startActivity(state, config);
 }
 
 /**