expo-live-activity 0.4.1-alpha1 → 0.4.2

package/README.md

@@ -62,11 +62,14 @@ The module comes with a built-in config plugin that creates a target in iOS with
 2. **Assets configuration:**
    Place images intended for Live Activities in the `assets/liveActivity` folder. The plugin manages these assets automatically.
 
-Then prebuild your app with:
+   Then prebuild your app with:
 
-```sh
-npx expo prebuild --clean
-```
+   ```sh
+   npx expo prebuild --clean
+   ```
+
+> [!NOTE]
+> Because of iOS limitations, the assets can't be bigger than 4KB ([native Live Activity documentation](https://developer.apple.com/documentation/activitykit/displaying-live-data-with-live-activities#Understand-constraints))
 
 ### Step 3: Usage in Your React Native App
 
@@ -153,7 +156,9 @@ The `config` object should include:
    timerType?: DynamicIslandTimerType; // "circular" | "digital" - defines timer appearance on the dynamic island
    padding?: Padding // number | {top?: number bottom?: number ...}
    imagePosition?: ImagePosition; // 'left' | 'right';
-   imageSize?: ImageSize // 'fullHeight' | 'default';
+   imageAlign?: ImageAlign; // 'top' | 'center' | 'bottom'
+   imageSize?: ImageSize // { width: number|`${number}%`, height: number|`${number}%` } | undefined (defaults to 64pt)
+   contentFit?: ImageContentFit; // 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'
 };
 ```
 
@@ -186,7 +191,9 @@ const config: LiveActivity.LiveActivityConfig = {
   timerType: 'circular',
   padding: { horizontal: 20, top: 16, bottom: 16 },
   imagePosition: 'right',
-  imageSize: 'default',
+  imageAlign: 'center',
+  imageSize: { height: '50%', width: '50%' }, // number (pt) or percentage of the image container, if empty by default is 64pt.
+  contentFit: 'cover',
 }
 
 const activityId = LiveActivity.startActivity(state, config)

package/build/index.d.ts

@@ -31,8 +31,14 @@ export type Padding = {
     vertical?: number;
     horizontal?: number;
 } | number;
-export type ImagePosition = 'left' | 'right';
-export type ImageSize = 'fullHeight' | 'default';
+export type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch';
+export type ImageAlign = 'top' | 'center' | 'bottom';
+export type ImageDimension = number | `${number}%`;
+export type ImageSize = {
+    width: ImageDimension;
+    height: ImageDimension;
+};
+export type ImageContentFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down';
 export type LiveActivityConfig = {
     backgroundColor?: string;
     titleColor?: string;
@@ -43,7 +49,9 @@ export type LiveActivityConfig = {
     timerType?: DynamicIslandTimerType;
     padding?: Padding;
     imagePosition?: ImagePosition;
+    imageAlign?: ImageAlign;
     imageSize?: ImageSize;
+    contentFit?: ImageContentFit;
 };
 export type ActivityTokenReceivedEvent = {
     activityID: string;

package/build/index.d.ts.map

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

package/build/index.js

@@ -6,21 +6,55 @@ function assertIOS(name) {
         console.error(`${name} is only available on iOS`);
     return isIOS;
 }
+function normalizeConfig(config) {
+    if (config === undefined)
+        return config;
+    const { padding, imageSize, ...base } = config;
+    const normalized = { ...base };
+    // Normalize padding: keep number in padding, object in paddingDetails
+    if (typeof padding === 'number') {
+        normalized.padding = padding;
+    }
+    else if (typeof padding === 'object') {
+        normalized.paddingDetails = padding;
+    }
+    // Normalize imageSize: object with width/height each a number (points) or percent string like '50%'
+    if (imageSize) {
+        const regExp = /^(100(?:\.0+)?|\d{1,2}(?:\.\d+)?)%$/; // Matches 0.0% to 100.0%
+        const { width, height } = imageSize;
+        if (typeof width === 'number') {
+            normalized.imageWidth = width;
+        }
+        else if (typeof width === 'string') {
+            const match = width.trim().match(regExp);
+            if (match) {
+                normalized.imageWidthPercent = Number(match[1]);
+            }
+            else {
+                throw new Error('imageSize.width percent string must be in format "0%" to "100%"');
+            }
+        }
+        if (typeof height === 'number') {
+            normalized.imageHeight = height;
+        }
+        else if (typeof height === 'string') {
+            const match = height.trim().match(regExp);
+            if (match) {
+                normalized.imageHeightPercent = Number(match[1]);
+            }
+            else {
+                throw new Error('imageSize.height percent string must be in format "0%" to "100%"');
+            }
+        }
+    }
+    return normalized;
+}
 /**
  * @param {LiveActivityState} state The state for the live activity.
  * @param {LiveActivityConfig} config Live activity config object.
  * @returns {string} The identifier of the started activity or undefined if creating live activity failed.
  */
 export function startActivity(state, config) {
-    function normalizeConfig(config) {
-        if (typeof config?.padding === 'number') {
-            return { ...config, padding: config.padding, paddingDetails: undefined };
-        }
-        if (typeof config?.padding === 'object') {
-            return { ...config, padding: undefined, paddingDetails: config.padding };
-        }
-        return config;
-    }
     if (assertIOS('startActivity'))
         return ExpoLiveActivityModule.startActivity(state, normalizeConfig(config));
 }

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAqF7D,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAA;IAEnC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,2BAA2B,CAAC,CAAA;IAE7D,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,MAA2B;IACjF,SAAS,eAAe,CAAC,MAA2B;QAClD,IAAI,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAA;QAC1E,CAAC;QACD,IAAI,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;QAC1E,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,SAAS,CAAC,eAAe,CAAC;QAAE,OAAO,sBAAsB,CAAC,aAAa,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAA;AAC7G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,KAAwB;IAC/D,IAAI,SAAS,CAAC,cAAc,CAAC;QAAE,OAAO,sBAAsB,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,KAAwB;IACjE,IAAI,SAAS,CAAC,gBAAgB,CAAC;QAAE,OAAO,sBAAsB,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;AAC1F,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAqD;IAErD,IAAI,SAAS,CAAC,0BAA0B,CAAC;QAAE,OAAO,sBAAsB,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAA;AACnH,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,QAAgE;IAEhE,IAAI,SAAS,CAAC,qCAAqC,CAAC;QAClD,OAAO,sBAAsB,CAAC,WAAW,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAA8C;IAE9C,IAAI,SAAS,CAAC,4BAA4B,CAAC;QAAE,OAAO,sBAAsB,CAAC,WAAW,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;AACnH,CAAC","sourcesContent":["import { EventSubscription } from 'expo-modules-core'\nimport { Platform } from 'react-native'\n\nimport ExpoLiveActivityModule from './ExpoLiveActivityModule'\n\ntype Voidable<T> = T | void\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\ntype ProgressBarType =\n  | {\n      date?: number\n      progress?: undefined\n    }\n  | {\n      date?: undefined\n      progress?: number\n    }\n\nexport type LiveActivityState = {\n  title: string\n  subtitle?: string\n  progressBar?: ProgressBarType\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type NativeLiveActivityState = {\n  title: string\n  subtitle?: string\n  date?: number\n  progress?: number\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type Padding =\n  | {\n      top?: number\n      bottom?: number\n      left?: number\n      right?: number\n      vertical?: number\n      horizontal?: number\n    }\n  | number\n\nexport type ImagePosition = 'left' | 'right'\n\nexport type ImageSize = 'fullHeight' | 'default'\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  padding?: Padding\n  imagePosition?: ImagePosition\n  imageSize?: ImageSize\n}\n\nexport type ActivityTokenReceivedEvent = {\n  activityID: string\n  activityName: string\n  activityPushToken: string\n}\n\nexport type ActivityPushToStartTokenReceivedEvent = {\n  activityPushToStartToken: string\n}\n\ntype ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended'\n\nexport type ActivityUpdateEvent = {\n  activityID: string\n  activityName: string\n  activityState: ActivityState\n}\n\nexport type LiveActivityModuleEvents = {\n  onTokenReceived: (params: ActivityTokenReceivedEvent) => void\n  onPushToStartTokenReceived: (params: ActivityPushToStartTokenReceivedEvent) => void\n  onStateChange: (params: ActivityUpdateEvent) => void\n}\n\nfunction assertIOS(name: string) {\n  const isIOS = Platform.OS === 'ios'\n\n  if (!isIOS) console.error(`${name} is only available on iOS`)\n\n  return isIOS\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 or undefined if creating live activity failed.\n */\nexport function startActivity(state: LiveActivityState, config?: LiveActivityConfig): Voidable<string> {\n  function normalizeConfig(config?: LiveActivityConfig) {\n    if (typeof config?.padding === 'number') {\n      return { ...config, padding: config.padding, paddingDetails: undefined }\n    }\n    if (typeof config?.padding === 'object') {\n      return { ...config, padding: undefined, paddingDetails: config.padding }\n    }\n    return config\n  }\n\n  if (assertIOS('startActivity')) return ExpoLiveActivityModule.startActivity(state, normalizeConfig(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 */\nexport function stopActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('stopActivity')) 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 */\nexport function updateActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('updateActivity')) return ExpoLiveActivityModule.updateActivity(id, state)\n}\n\nexport function addActivityTokenListener(\n  listener: (event: ActivityTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityTokenListener')) return ExpoLiveActivityModule.addListener('onTokenReceived', listener)\n}\n\nexport function addActivityPushToStartTokenListener(\n  listener: (event: ActivityPushToStartTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityPushToStartTokenListener'))\n    return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener)\n}\n\nexport function addActivityUpdatesListener(\n  listener: (event: ActivityUpdateEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityUpdatesListener')) return ExpoLiveActivityModule.addListener('onStateChange', listener)\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventSubscription } from 'expo-modules-core'\nimport { Platform } from 'react-native'\n\nimport ExpoLiveActivityModule from './ExpoLiveActivityModule'\n\ntype Voidable<T> = T | void\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\ntype ProgressBarType =\n  | {\n      date?: number\n      progress?: undefined\n    }\n  | {\n      date?: undefined\n      progress?: number\n    }\n\nexport type LiveActivityState = {\n  title: string\n  subtitle?: string\n  progressBar?: ProgressBarType\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type NativeLiveActivityState = {\n  title: string\n  subtitle?: string\n  date?: number\n  progress?: number\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type Padding =\n  | {\n      top?: number\n      bottom?: number\n      left?: number\n      right?: number\n      vertical?: number\n      horizontal?: number\n    }\n  | number\n\nexport type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch'\n\nexport type ImageAlign = 'top' | 'center' | 'bottom'\n\nexport type ImageDimension = number | `${number}%`\nexport type ImageSize = {\n  width: ImageDimension\n  height: ImageDimension\n}\n\nexport type ImageContentFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'\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  padding?: Padding\n  imagePosition?: ImagePosition\n  imageAlign?: ImageAlign\n  imageSize?: ImageSize\n  contentFit?: ImageContentFit\n}\n\nexport type ActivityTokenReceivedEvent = {\n  activityID: string\n  activityName: string\n  activityPushToken: string\n}\n\nexport type ActivityPushToStartTokenReceivedEvent = {\n  activityPushToStartToken: string\n}\n\ntype ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended'\n\nexport type ActivityUpdateEvent = {\n  activityID: string\n  activityName: string\n  activityState: ActivityState\n}\n\nexport type LiveActivityModuleEvents = {\n  onTokenReceived: (params: ActivityTokenReceivedEvent) => void\n  onPushToStartTokenReceived: (params: ActivityPushToStartTokenReceivedEvent) => void\n  onStateChange: (params: ActivityUpdateEvent) => void\n}\n\nfunction assertIOS(name: string) {\n  const isIOS = Platform.OS === 'ios'\n\n  if (!isIOS) console.error(`${name} is only available on iOS`)\n\n  return isIOS\n}\n\nfunction normalizeConfig(config?: LiveActivityConfig) {\n  if (config === undefined) return config\n\n  const { padding, imageSize, ...base } = config\n  type NormalizedConfig = LiveActivityConfig & {\n    paddingDetails?: Padding\n    imageWidth?: number\n    imageHeight?: number\n    imageWidthPercent?: number\n    imageHeightPercent?: number\n  }\n  const normalized: NormalizedConfig = { ...base }\n\n  // Normalize padding: keep number in padding, object in paddingDetails\n  if (typeof padding === 'number') {\n    normalized.padding = padding\n  } else if (typeof padding === 'object') {\n    normalized.paddingDetails = padding\n  }\n\n  // Normalize imageSize: object with width/height each a number (points) or percent string like '50%'\n  if (imageSize) {\n    const regExp = /^(100(?:\\.0+)?|\\d{1,2}(?:\\.\\d+)?)%$/ // Matches 0.0% to 100.0%\n\n    const { width, height } = imageSize\n\n    if (typeof width === 'number') {\n      normalized.imageWidth = width\n    } else if (typeof width === 'string') {\n      const match = width.trim().match(regExp)\n      if (match) {\n        normalized.imageWidthPercent = Number(match[1])\n      } else {\n        throw new Error('imageSize.width percent string must be in format \"0%\" to \"100%\"')\n      }\n    }\n\n    if (typeof height === 'number') {\n      normalized.imageHeight = height\n    } else if (typeof height === 'string') {\n      const match = height.trim().match(regExp)\n      if (match) {\n        normalized.imageHeightPercent = Number(match[1])\n      } else {\n        throw new Error('imageSize.height percent string must be in format \"0%\" to \"100%\"')\n      }\n    }\n  }\n\n  return normalized\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 or undefined if creating live activity failed.\n */\nexport function startActivity(state: LiveActivityState, config?: LiveActivityConfig): Voidable<string> {\n  if (assertIOS('startActivity')) return ExpoLiveActivityModule.startActivity(state, normalizeConfig(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 */\nexport function stopActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('stopActivity')) 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 */\nexport function updateActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('updateActivity')) return ExpoLiveActivityModule.updateActivity(id, state)\n}\n\nexport function addActivityTokenListener(\n  listener: (event: ActivityTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityTokenListener')) return ExpoLiveActivityModule.addListener('onTokenReceived', listener)\n}\n\nexport function addActivityPushToStartTokenListener(\n  listener: (event: ActivityPushToStartTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityPushToStartTokenListener'))\n    return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener)\n}\n\nexport function addActivityUpdatesListener(\n  listener: (event: ActivityUpdateEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityUpdatesListener')) return ExpoLiveActivityModule.addListener('onStateChange', listener)\n}\n"]}

package/ios/ExpoLiveActivityModule.swift

@@ -59,7 +59,22 @@ public class ExpoLiveActivityModule: Module {
     var imagePosition: String?
 
     @Field
-    var imageSize: String?
+    var imageWidth: Int?
+
+    @Field
+    var imageHeight: Int?
+
+    @Field
+    var imageWidthPercent: Double?
+
+    @Field
+    var imageHeightPercent: Double?
+
+    @Field
+    var imageAlign: String?
+
+    @Field
+    var contentFit: String?
 
     struct PaddingDetails: Record {
       @Field var top: Int?
@@ -222,7 +237,12 @@ public class ExpoLiveActivityModule: Module {
             )
           },
           imagePosition: config.imagePosition,
-          imageSize: config.imageSize
+          imageWidth: config.imageWidth,
+          imageHeight: config.imageHeight,
+          imageWidthPercent: config.imageWidthPercent,
+          imageHeightPercent: config.imageHeightPercent,
+          imageAlign: config.imageAlign,
+          contentFit: config.contentFit
         )
 
         let initialState = LiveActivityAttributes.ContentState(

package/ios/LiveActivityAttributes.swift

@@ -22,7 +22,12 @@ struct LiveActivityAttributes: ActivityAttributes {
   var padding: Int?
   var paddingDetails: PaddingDetails?
   var imagePosition: String?
-  var imageSize: String?
+  var imageWidth: Int?
+  var imageHeight: Int?
+  var imageWidthPercent: Double?
+  var imageHeightPercent: Double?
+  var imageAlign: String?
+  var contentFit: String?
 
   enum DynamicIslandTimerType: String, Codable {
     case circular

package/ios-files/Image+dynamic.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+import UIKit
 
 extension Image {
   static func dynamic(assetNameOrPath: String) -> Self {
@@ -15,3 +16,18 @@ extension Image {
     return Image(assetNameOrPath)
   }
 }
+
+extension UIImage {
+  /// Attempts to load a UIImage either from the shared app group container or the main bundle.
+  static func dynamic(assetNameOrPath: String) -> UIImage? {
+    if let container = FileManager.default.containerURL(
+      forSecurityApplicationGroupIdentifier: "group.expoLiveActivity.sharedData"
+    ) {
+      let contentsOfFile = container.appendingPathComponent(assetNameOrPath).path
+      if let uiImage = UIImage(contentsOfFile: contentsOfFile) {
+        return uiImage
+      }
+    }
+    return UIImage(named: assetNameOrPath)
+  }
+}

package/ios-files/LiveActivityView.swift

@@ -15,14 +15,141 @@ import WidgetKit
     }
   }
 
+  struct DebugLog: View {
+    #if DEBUG
+      private let message: String
+      init(_ message: String) {
+        self.message = message
+        print(message)
+      }
+
+      var body: some View {
+        Text(message)
+          .font(.caption2)
+          .foregroundStyle(.red)
+      }
+    #else
+      init(_: String) {}
+      var body: some View { EmptyView() }
+    #endif
+  }
+
   struct LiveActivityView: View {
     let contentState: LiveActivityAttributes.ContentState
     let attributes: LiveActivityAttributes
+    @State private var imageContainerSize: CGSize?
 
     var progressViewTint: Color? {
       attributes.progressViewTint.map { Color(hex: $0) }
     }
 
+    private var imageAlignment: Alignment {
+      switch attributes.imageAlign {
+      case "center":
+        return .center
+      case "bottom":
+        return .bottom
+      default:
+        return .top
+      }
+    }
+
+    private func alignedImage(imageName: String) -> some View {
+      let defaultHeight: CGFloat = 64
+      let defaultWidth: CGFloat = 64
+      let containerHeight = imageContainerSize?.height
+      let containerWidth = imageContainerSize?.width
+      let hasWidthConstraint = (attributes.imageWidthPercent != nil) || (attributes.imageWidth != nil)
+
+      let computedHeight: CGFloat? = {
+        if let percent = attributes.imageHeightPercent {
+          let clamped = min(max(percent, 0), 100) / 100.0
+          // Use the row height as a base. Fallback to default when row height is not measured yet.
+          let base = (containerHeight ?? defaultHeight)
+          return base * clamped
+        } else if let size = attributes.imageHeight {
+          return CGFloat(size)
+        } else if hasWidthConstraint {
+          // Mimic CSS: when only width is set, keep height automatic to preserve aspect ratio
+          return nil
+        } else {
+          // Mimic CSS: this works against CSS but provides a better default behavior.
+          // When no width/height is set, use a default size (64pt)
+          // Width will adjust automatically base on aspect ratio
+          return defaultHeight
+        }
+      }()
+
+      let computedWidth: CGFloat? = {
+        if let percent = attributes.imageWidthPercent {
+          let clamped = min(max(percent, 0), 100) / 100.0
+          let base = (containerWidth ?? defaultWidth)
+          return base * clamped
+        } else if let size = attributes.imageWidth {
+          return CGFloat(size)
+        } else {
+          return nil // Keep aspect fit based on height
+        }
+      }()
+
+      return ZStack(alignment: .center) {
+        Group {
+          let fit = attributes.contentFit ?? "cover"
+          switch fit {
+          case "contain":
+            Image.dynamic(assetNameOrPath: imageName).resizable().scaledToFit().frame(width: computedWidth, height: computedHeight)
+          case "fill":
+            Image.dynamic(assetNameOrPath: imageName).resizable().frame(
+              width: computedWidth,
+              height: computedHeight
+            )
+          case "none":
+            Image.dynamic(assetNameOrPath: imageName).renderingMode(.original).frame(width: computedWidth, height: computedHeight)
+          case "scale-down":
+            if let uiImage = UIImage.dynamic(assetNameOrPath: imageName) {
+              // Determine the target box. When width/height are nil, we use image's intrinsic dimension for comparison.
+              let targetHeight = computedHeight ?? uiImage.size.height
+              let targetWidth = computedWidth ?? uiImage.size.width
+              let shouldScaleDown = uiImage.size.height > targetHeight || uiImage.size.width > targetWidth
+
+              if shouldScaleDown {
+                Image(uiImage: uiImage)
+                  .resizable()
+                  .scaledToFit()
+                  .frame(width: computedWidth, height: computedHeight)
+              } else {
+                Image(uiImage: uiImage)
+                  .renderingMode(.original)
+                  .frame(width: min(uiImage.size.width, targetWidth), height: min(uiImage.size.height, targetHeight))
+              }
+            } else {
+              DebugLog("⚠️[ExpoLiveActivity] assetNameOrPath couldn't resolve to UIImage")
+            }
+          case "cover":
+            Image.dynamic(assetNameOrPath: imageName).resizable().scaledToFill().frame(
+              width: computedWidth,
+              height: computedHeight
+            ).clipped()
+          default:
+            DebugLog("⚠️[ExpoLiveActivity] Unknown contentFit '\(fit)'")
+          }
+        }
+      }
+      .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: imageAlignment)
+      .background(
+        GeometryReader { proxy in
+          Color.clear
+            .onAppear {
+              let s = proxy.size
+              if s.width > 0, s.height > 0 { imageContainerSize = s }
+            }
+            .onChange(of: proxy.size) { s in
+              if s.width > 0, s.height > 0 { imageContainerSize = s }
+            }
+        }
+      )
+    }
+
     var body: some View {
       let defaultPadding = 24
 
@@ -55,11 +182,16 @@ import WidgetKit
       )
 
       VStack(alignment: .leading) {
+        let position = attributes.imagePosition ?? "right"
+        let isStretch = position.contains("Stretch")
+        let isLeftImage = position.hasPrefix("left")
+        let hasImage = contentState.imageName != nil
+        let effectiveStretch = isStretch && hasImage
+
         HStack(alignment: .center) {
-          if attributes.imagePosition == "left" {
+          if hasImage, isLeftImage {
             if let imageName = contentState.imageName {
-              resizableImage(imageName: imageName)
-                .applyImageSize(attributes.imageSize)
+              alignedImage(imageName: imageName)
             }
           }
 
@@ -75,7 +207,7 @@ import WidgetKit
                 .modifier(ConditionalForegroundViewModifier(color: attributes.subtitleColor))
             }
 
-            if attributes.imageSize == "fullHeight" {
+            if effectiveStretch {
               if let date = contentState.timerEndDateInMilliseconds {
                 ProgressView(timerInterval: Date.toTimerInterval(miliseconds: date))
                   .tint(progressViewTint)
@@ -86,18 +218,17 @@ import WidgetKit
                   .modifier(ConditionalForegroundViewModifier(color: attributes.progressViewLabelColor))
               }
             }
-          }
+          }.layoutPriority(1)
 
-          if attributes.imagePosition == "right" || attributes.imagePosition == nil {
+          if hasImage, !isLeftImage { // right side (default)
             Spacer()
             if let imageName = contentState.imageName {
-              resizableImage(imageName: imageName)
-                .applyImageSize(attributes.imageSize)
+              alignedImage(imageName: imageName)
             }
           }
         }
 
-        if attributes.imageSize != "fullHeight" {
+        if !effectiveStretch {
           if let date = contentState.timerEndDateInMilliseconds {
             ProgressView(timerInterval: Date.toTimerInterval(miliseconds: date))
               .tint(progressViewTint)

package/ios-files/LiveActivityWidget.swift

@@ -23,7 +23,12 @@ struct LiveActivityAttributes: ActivityAttributes {
   var padding: Int?
   var paddingDetails: PaddingDetails?
   var imagePosition: String?
-  var imageSize: String?
+  var imageWidth: Int?
+  var imageHeight: Int?
+  var imageWidthPercent: Double?
+  var imageHeightPercent: Double?
+  var imageAlign: String?
+  var contentFit: String?
 
   enum DynamicIslandTimerType: String, Codable {
     case circular
@@ -139,7 +144,6 @@ struct LiveActivityWidget: Widget {
     VStack {
       Spacer()
       resizableImage(imageName: imageName)
-        .frame(maxHeight: 64)
       Spacer()
     }
   }

package/ios-files/ViewHelpers.swift

@@ -6,14 +6,28 @@ func resizableImage(imageName: String) -> some View {
     .scaledToFit()
 }
 
+func resizableImage(imageName: String, height: CGFloat?, width: CGFloat?) -> some View {
+  resizableImage(imageName: imageName)
+    .frame(width: width, height: height)
+}
+
+private struct ContainerSizeKey: PreferenceKey {
+  static var defaultValue: CGSize?
+  static func reduce(value: inout CGSize?, nextValue: () -> CGSize?) {
+    value = nextValue() ?? value
+  }
+}
+
 extension View {
-  @ViewBuilder
-  func applyImageSize(_ size: String?) -> some View {
-    switch size {
-    case "fullHeight":
-      frame(maxHeight: .infinity)
-    default:
-      frame(maxHeight: 64)
-    }
+  func captureContainerSize() -> some View {
+    background(
+      GeometryReader { proxy in
+        Color.clear.preference(key: ContainerSizeKey.self, value: proxy.size)
+      }
+    )
+  }
+
+  func onContainerSize(_ perform: @escaping (CGSize?) -> Void) -> some View {
+    onPreferenceChange(ContainerSizeKey.self, perform: perform)
   }
 }

package/package.json

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

package/plugin/build/index.js

@@ -11,7 +11,7 @@ const withWidgetExtensionEntitlements_1 = require("./withWidgetExtensionEntitlem
 const withXcode_1 = require("./withXcode");
 const withWidgetsAndLiveActivities = (config, props) => {
     const deploymentTarget = '16.2';
-    const targetName = `${config_plugins_1.IOSConfig.XcodeUtils.sanitizedName(config.name)}LiveActivity`;
+    const targetName = 'LiveActivity';
     const bundleIdentifier = `${config.ios?.bundleIdentifier}.${targetName}`;
     config.ios = {
         ...config.ios,

package/plugin/build/withPlist.js

@@ -3,8 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const config_plugins_1 = require("@expo/config-plugins");
 const withPlist = (expoConfig) => (0, config_plugins_1.withInfoPlist)(expoConfig, (plistConfig) => {
     const scheme = typeof expoConfig.scheme === 'string' ? expoConfig.scheme : expoConfig.ios?.bundleIdentifier;
-    if (scheme)
-        plistConfig.modResults.CFBundleURLTypes = [{ CFBundleURLSchemes: [scheme] }];
+    if (scheme) {
+        const existingURLTypes = plistConfig.modResults.CFBundleURLTypes || [];
+        const schemeExists = existingURLTypes.some((urlType) => urlType.CFBundleURLSchemes?.includes(scheme));
+        if (!schemeExists) {
+            plistConfig.modResults.CFBundleURLTypes = [...existingURLTypes, { CFBundleURLSchemes: [scheme] }];
+        }
+    }
     return plistConfig;
 });
 exports.default = withPlist;

package/plugin/src/index.ts

@@ -1,4 +1,4 @@
-import { IOSConfig, withPlugins } from 'expo/config-plugins'
+import { withPlugins } from 'expo/config-plugins'
 
 import type { LiveActivityConfigPlugin } from './types'
 import { withConfig } from './withConfig'
@@ -9,7 +9,7 @@ import { withXcode } from './withXcode'
 
 const withWidgetsAndLiveActivities: LiveActivityConfigPlugin = (config, props) => {
   const deploymentTarget = '16.2'
-  const targetName = `${IOSConfig.XcodeUtils.sanitizedName(config.name)}LiveActivity`
+  const targetName = 'LiveActivity'
   const bundleIdentifier = `${config.ios?.bundleIdentifier}.${targetName}`
 
   config.ios = {

package/plugin/src/withPlist.ts

@@ -3,7 +3,16 @@ import { ConfigPlugin, withInfoPlist } from '@expo/config-plugins'
 const withPlist: ConfigPlugin = (expoConfig) =>
   withInfoPlist(expoConfig, (plistConfig) => {
     const scheme = typeof expoConfig.scheme === 'string' ? expoConfig.scheme : expoConfig.ios?.bundleIdentifier
-    if (scheme) plistConfig.modResults.CFBundleURLTypes = [{ CFBundleURLSchemes: [scheme] }]
+
+    if (scheme) {
+      const existingURLTypes = plistConfig.modResults.CFBundleURLTypes || []
+      const schemeExists = existingURLTypes.some((urlType: any) => urlType.CFBundleURLSchemes?.includes(scheme))
+
+      if (!schemeExists) {
+        plistConfig.modResults.CFBundleURLTypes = [...existingURLTypes, { CFBundleURLSchemes: [scheme] }]
+      }
+    }
+
     return plistConfig
   })
 

package/src/index.ts

@@ -45,9 +45,17 @@ export type Padding =
     }
   | number
 
-export type ImagePosition = 'left' | 'right'
+export type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch'
 
-export type ImageSize = 'fullHeight' | 'default'
+export type ImageAlign = 'top' | 'center' | 'bottom'
+
+export type ImageDimension = number | `${number}%`
+export type ImageSize = {
+  width: ImageDimension
+  height: ImageDimension
+}
+
+export type ImageContentFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'
 
 export type LiveActivityConfig = {
   backgroundColor?: string
@@ -59,7 +67,9 @@ export type LiveActivityConfig = {
   timerType?: DynamicIslandTimerType
   padding?: Padding
   imagePosition?: ImagePosition
+  imageAlign?: ImageAlign
   imageSize?: ImageSize
+  contentFit?: ImageContentFit
 }
 
 export type ActivityTokenReceivedEvent = {
@@ -94,22 +104,64 @@ function assertIOS(name: string) {
   return isIOS
 }
 
+function normalizeConfig(config?: LiveActivityConfig) {
+  if (config === undefined) return config
+
+  const { padding, imageSize, ...base } = config
+  type NormalizedConfig = LiveActivityConfig & {
+    paddingDetails?: Padding
+    imageWidth?: number
+    imageHeight?: number
+    imageWidthPercent?: number
+    imageHeightPercent?: number
+  }
+  const normalized: NormalizedConfig = { ...base }
+
+  // Normalize padding: keep number in padding, object in paddingDetails
+  if (typeof padding === 'number') {
+    normalized.padding = padding
+  } else if (typeof padding === 'object') {
+    normalized.paddingDetails = padding
+  }
+
+  // Normalize imageSize: object with width/height each a number (points) or percent string like '50%'
+  if (imageSize) {
+    const regExp = /^(100(?:\.0+)?|\d{1,2}(?:\.\d+)?)%$/ // Matches 0.0% to 100.0%
+
+    const { width, height } = imageSize
+
+    if (typeof width === 'number') {
+      normalized.imageWidth = width
+    } else if (typeof width === 'string') {
+      const match = width.trim().match(regExp)
+      if (match) {
+        normalized.imageWidthPercent = Number(match[1])
+      } else {
+        throw new Error('imageSize.width percent string must be in format "0%" to "100%"')
+      }
+    }
+
+    if (typeof height === 'number') {
+      normalized.imageHeight = height
+    } else if (typeof height === 'string') {
+      const match = height.trim().match(regExp)
+      if (match) {
+        normalized.imageHeightPercent = Number(match[1])
+      } else {
+        throw new Error('imageSize.height percent string must be in format "0%" to "100%"')
+      }
+    }
+  }
+
+  return normalized
+}
+
 /**
  * @param {LiveActivityState} state The state for the live activity.
  * @param {LiveActivityConfig} config Live activity config object.
  * @returns {string} The identifier of the started activity or undefined if creating live activity failed.
  */
 export function startActivity(state: LiveActivityState, config?: LiveActivityConfig): Voidable<string> {
-  function normalizeConfig(config?: LiveActivityConfig) {
-    if (typeof config?.padding === 'number') {
-      return { ...config, padding: config.padding, paddingDetails: undefined }
-    }
-    if (typeof config?.padding === 'object') {
-      return { ...config, padding: undefined, paddingDetails: config.padding }
-    }
-    return config
-  }
-
   if (assertIOS('startActivity')) return ExpoLiveActivityModule.startActivity(state, normalizeConfig(config))
 }