expo-live-activity 0.4.0 → 0.4.1-alpha1

package/.swiftformat

@@ -0,0 +1,2 @@
+--indent 2
+--swift-version 5.4 

package/README.md

@@ -1,16 +1,18 @@
+![expo-live-activity by Software Mansion](https://github.com/user-attachments/assets/9f9be263-84ee-4034-a3ca-39c72c189544)
+
 > [!WARNING]  
-> This library is in early development stage, breaking changes can be introduced in minor version upgrades.
+> 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.
+`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.
 
 ## Features
 
-- Start, update, and stop live activities directly from your React Native application.
+- 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.
+- 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
 
@@ -19,7 +21,7 @@
 ## Installation
 
 > [!NOTE]  
-> The library isn't supported in Expo Go, to set it up correctly you need to use [Expo DevClient](https://docs.expo.dev/versions/latest/sdk/dev-client/) .
+> The library isn't supported in Expo Go; to set it up correctly you need to use [Expo DevClient](https://docs.expo.dev/versions/latest/sdk/dev-client/) .
 > To begin using `expo-live-activity`, follow the installation and configuration steps outlined below:
 
 ### Step 1: Installation
@@ -32,7 +34,7 @@ npm install expo-live-activity
 
 ### Step 2: Config Plugin Setup
 
-The module comes with a built-in config plugin that creates a target in iOS with all the necessary files. The images used in live activities should be added to a pre-defined folder in your assets directory:
+The module comes with a built-in config plugin that creates a target in iOS with all the necessary files. The images used in Live Activities should be added to a pre-defined folder in your assets directory:
 
 1. **Add the config plugin to your app.json or app.config.js:**
    ```json
@@ -58,7 +60,7 @@ 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.
+   Place images intended for Live Activities in the `assets/liveActivity` folder. The plugin manages these assets automatically.
 
 Then prebuild your app with:
 
@@ -76,29 +78,29 @@ import * as LiveActivity from 'expo-live-activity'
 
 ## API
 
-`expo-live-activity` module exports three primary functions to manage live activities:
+`expo-live-activity` module exports three primary functions to manage Live Activities:
 
 ### Managing Live Activities
 
 - **`startActivity(state: LiveActivityState, config?: LiveActivityConfig): string | undefined`**:
-  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. If the live activity can't be created (eg. on android or iOS lower than 16.2), it will return `undefined`.
+  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. If the Live Activity can't be created (eg. on android or iOS lower than 16.2), it will return `undefined`.
 
 - **`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.
+  Update an existing Live Activity. The `state` object should contain updated information. The `activityId` indicates which activity should be updated.
 
 - **`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.
+  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
 
 - **`addActivityPushToStartTokenListener(listener: (event: ActivityPushToStartTokenReceivedEvent) => void): EventSubscription | undefined`**:
   Subscribe to changes in the push to start token for starting live acitivities with push notifications.
 - **`addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription | undefined`**:
-  Subscribe to changes in the push notification token associated with live activities.
+  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 usually should be a path to one of your screens. If you are using @react-navigation in your project, it's easiest to enable auto linking:
+When starting a new Live Activity, it's possible to pass `deepLinkUrl` field in `config` object. This usually should be a path to one of your screens. If you are using @react-navigation in your project, it's easiest to enable auto linking:
 
 ```typescript
 const prefix = Linking.createURL('')
@@ -148,17 +150,20 @@ The `config` object should include:
    progressViewTint?: string;
    progressViewLabelColor?: string;
    deepLinkUrl?: string;
-   timerType?: DynamicIslandTimerType; // "circular" | "digital" - defines timer appereance on the dynamic island
+   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';
 };
 ```
 
 ### Activity updates
 
-`LiveActivity.addActivityUpdatesListener` API allows to subscribe to changes in live activity state. This is useful for example when you want to update the live activity with new information. Handler will receive an `ActivityUpdateEvent` object which contains information about new state under `activityState` property which is of `ActivityState` type, so the possible values are: `'active'`, `'dismissed'`, `'pending'`, `'stale'` or `'ended'`. Apart from this property, the event also contains `activityId` and `activityName` which can be used to identify the live activity.
+`LiveActivity.addActivityUpdatesListener` API allows to subscribe to changes in Live Activity state. This is useful for example when you want to update the Live Activity with new information. Handler will receive an `ActivityUpdateEvent` object which contains information about new state under `activityState` property which is of `ActivityState` type, so the possible values are: `'active'`, `'dismissed'`, `'pending'`, `'stale'` or `'ended'`. Apart from this property, the event also contains `activityId` and `activityName` which can be used to identify the Live Activity.
 
 ## Example Usage
 
-Managing a live activity:
+Managing a Live Activity:
 
 ```typescript
 const state: LiveActivity.LiveActivityState = {
@@ -179,13 +184,16 @@ const config: LiveActivity.LiveActivityConfig = {
   progressViewLabelColor: '#FFFFFF',
   deepLinkUrl: '/dashboard',
   timerType: 'circular',
+  padding: { horizontal: 20, top: 16, bottom: 16 },
+  imagePosition: 'right',
+  imageSize: 'default',
 }
 
 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.
+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:
 
@@ -193,12 +201,12 @@ Subscribing to push token changes:
 useEffect(() => {
   const updateTokenSubscription = LiveActivity.addActivityTokenListener(
     ({ activityID: newActivityID, activityName: newName, activityPushToken: newToken }) => {
-      // Send token to a remote server to update live activity with push notifications
+      // Send token to a remote server to update Live Activity with push notifications
     }
   )
   const startTokenSubscription = LiveActivity.addActivityPushToStartTokenListener(
     ({ activityPushToStartToken: newActivityPushToStartToken }) => {
-      // Send token to a remote server to start live activity with push notifications
+      // Send token to a remote server to start Live Activity with push notifications
     }
   )
 
@@ -214,20 +222,20 @@ useEffect(() => {
 
 ## Push notifications
 
-By default, starting and updating live activity is possible only via API. If you want to have possibility to start or update live activity using push notifications, you can enable that feature by adding `"enablePushNotifications": true` in the plugin config in your `app.json` or `app.config.ts` file.
+By default, starting and updating Live Activity is possible only via API. If you want to have possibility to start or update Live Activity using push notifications, you can enable that feature by adding `"enablePushNotifications": true` in the plugin config in your `app.json` or `app.config.ts` file.
 
 > [!NOTE]
 > PushToStart works only for iOS 17.2 and higher.
 
-Example payload for starting live activity:
+Example payload for starting Live Activity:
 
 ```json
 {
   "aps": {
     "event": "start",
     "content-state": {
-      "title": "Live activity title!",
-      "subtitle": "Live activity subtitle.",
+      "title": "Live Activity title!",
+      "subtitle": "Live Activity subtitle.",
       "timerEndDateInMilliseconds": 1754410997000,
       "progress": 0.5,
       "imageName": "live_activity_image",
@@ -243,7 +251,10 @@ Example payload for starting live activity:
       "progressViewTint": "38ACDD",
       "progressViewLabelColor": "FFFFFF",
       "deepLinkUrl": "/dashboard",
-      "timerType": "digital"
+      "timerType": "digital",
+      "padding": 24, // or use object to control each side: { "horizontal": 20, "top": 16, "bottom": 16 }
+      "imagePosition": "right",
+      "imageSize": "default"
     },
     "alert": {
       "title": "",
@@ -254,7 +265,7 @@ Example payload for starting live activity:
 }
 ```
 
-Example payload for updating live activity:
+Example payload for updating Live Activity:
 
 ```json
 {
@@ -272,11 +283,11 @@ Example payload for updating live activity:
 }
 ```
 
-Where `timerEndDateInMilliseconds` value is a timestamp in milliseconds corresponding to the target point of the counter displayed in live activity view.
+Where `timerEndDateInMilliseconds` 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 in the `state` object for that:
+Live Activity view also supports image display. There are two dedicated fields in the `state` object for that:
 
 - `imageName`
 - `dynamicIslandImageName`
@@ -284,7 +295,7 @@ Live activity view also supports image display. There are two dedicated fields i
 The value of each field can be:
 
 - a string which maps to an asset name
-- a URL to remote image - currently, it's possible to use this option only via API, but we plan on to add that feature to push notifications as well. It also requires adding "App Groups" capability to both "main app" and "live activity" targets.
+- a URL to remote image - currently, it's possible to use this option only via API, but we plan on to add that feature to push notifications as well. It also requires adding "App Groups" capability to both "main app" and "Live Activity" targets.
 
 ## expo-live-activity is created by Software Mansion
 

package/build/index.d.ts

@@ -23,6 +23,16 @@ export type NativeLiveActivityState = {
     imageName?: string;
     dynamicIslandImageName?: string;
 };
+export type Padding = {
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+    vertical?: number;
+    horizontal?: number;
+} | number;
+export type ImagePosition = 'left' | 'right';
+export type ImageSize = 'fullHeight' | 'default';
 export type LiveActivityConfig = {
     backgroundColor?: string;
     titleColor?: string;
@@ -31,6 +41,9 @@ export type LiveActivityConfig = {
     progressViewLabelColor?: string;
     deepLinkUrl?: string;
     timerType?: DynamicIslandTimerType;
+    padding?: Padding;
+    imagePosition?: ImagePosition;
+    imageSize?: ImageSize;
 };
 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":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAKrD,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAE3B,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAA;AAE3D,KAAK,eAAe,GAChB;IACE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,GACD;IACE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAEL,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,OAAO,GACf;IACE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GACD,MAAM,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAA;AAE5C,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;AAEhD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,sBAAsB,CAAA;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,qCAAqC,GAAG;IAClD,wBAAwB,EAAE,MAAM,CAAA;CACjC,CAAA;AAED,KAAK,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAE3E,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,aAAa,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAA;IAC7D,0BAA0B,EAAE,CAAC,MAAM,EAAE,qCAAqC,KAAK,IAAI,CAAA;IACnF,aAAa,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACrD,CAAA;AAUD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAYrG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAEhE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAElE;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GACpD,QAAQ,CAAC,iBAAiB,CAAC,CAE7B;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,CAAC,KAAK,EAAE,qCAAqC,KAAK,IAAI,GAC/D,QAAQ,CAAC,iBAAiB,CAAC,CAG7B;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAC7C,QAAQ,CAAC,iBAAiB,CAAC,CAE7B"}

package/build/index.js

@@ -12,8 +12,17 @@ function assertIOS(name) {
  * @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, config);
+        return ExpoLiveActivityModule.startActivity(state, normalizeConfig(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":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAmE7D,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,IAAI,SAAS,CAAC,eAAe,CAAC;QAAE,OAAO,sBAAsB,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AAC5F,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 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  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  if (assertIOS('startActivity')) 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 */\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":"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"]}

package/ios/Data+download.swift

@@ -1,10 +1,3 @@
-//
-//  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)

package/ios/ExpoLiveActivityModule.swift

@@ -1,13 +1,6 @@
 import ActivityKit
 import ExpoModulesCore
 
-enum LiveActivityErrors: Error {
-  case unsupportedOS
-  case notFound
-  case liveActivitiesNotEnabled
-  case unexpectedError(Error)
-}
-
 public class ExpoLiveActivityModule: Module {
   struct LiveActivityState: Record {
     @Field
@@ -18,7 +11,7 @@ public class ExpoLiveActivityModule: Module {
 
     @Field
     var progressBar: ProgressBar?
-      
+
     struct ProgressBar: Record {
       @Field
       var date: Double?
@@ -55,6 +48,27 @@ public class ExpoLiveActivityModule: Module {
 
     @Field
     var timerType: DynamicIslandTimerType?
+
+    @Field
+    var padding: Int?
+
+    @Field
+    var paddingDetails: PaddingDetails?
+
+    @Field
+    var imagePosition: String?
+
+    @Field
+    var imageSize: String?
+
+    struct PaddingDetails: Record {
+      @Field var top: Int?
+      @Field var bottom: Int?
+      @Field var left: Int?
+      @Field var right: Int?
+      @Field var vertical: Int?
+      @Field var horizontal: Int?
+    }
   }
 
   enum DynamicIslandTimerType: String, Enumerable {
@@ -78,13 +92,15 @@ public class ExpoLiveActivityModule: Module {
     sendEvent(
       "onPushToStartTokenReceived",
       [
-        "activityPushToStartToken": activityPushToStartToken
+        "activityPushToStartToken": activityPushToStartToken,
       ]
     )
   }
 
   @available(iOS 16.1, *)
-  private func sendStateChange(activity: Activity<LiveActivityAttributes>, activityState: ActivityState) {
+  private func sendStateChange(
+    activity: Activity<LiveActivityAttributes>, activityState: ActivityState
+  ) {
     sendEvent(
       "onStateChange",
       [
@@ -95,8 +111,9 @@ public class ExpoLiveActivityModule: Module {
     )
   }
 
-  private func updateImages(state: LiveActivityState, newState: inout LiveActivityAttributes.ContentState) async throws
-  {
+  private func updateImages(
+    state: LiveActivityState, newState: inout LiveActivityAttributes.ContentState
+  ) async throws {
     if let name = state.imageName {
       newState.imageName = try await resolveImage(from: name)
     }
@@ -157,7 +174,8 @@ public class ExpoLiveActivityModule: Module {
   }
 
   private var pushNotificationsEnabled: Bool {
-    Bundle.main.object(forInfoDictionaryKey: "ExpoLiveActivity_EnablePushNotifications") as? Bool ?? false
+    Bundle.main.object(forInfoDictionaryKey: "ExpoLiveActivity_EnablePushNotifications") as? Bool
+      ?? false
   }
 
   public func definition() -> ModuleDefinition {
@@ -172,12 +190,17 @@ public class ExpoLiveActivityModule: Module {
 
     Events("onTokenReceived", "onPushToStartTokenReceived", "onStateChange")
 
-    Function("startActivity") { (state: LiveActivityState, maybeConfig: LiveActivityConfig?) -> String in
-      guard #available(iOS 16.2, *) else { throw LiveActivityErrors.unsupportedOS }
-      guard ActivityAuthorizationInfo().areActivitiesEnabled else { throw LiveActivityErrors.liveActivitiesNotEnabled }
+    Function("startActivity") {
+      (state: LiveActivityState, maybeConfig: LiveActivityConfig?) -> String in
+      guard #available(iOS 16.2, *) else { throw UnsupportedOSException("16.2") }
+
+      guard ActivityAuthorizationInfo().areActivitiesEnabled else {
+        throw LiveActivitiesNotEnabledException()
+      }
 
       do {
         let config = maybeConfig ?? LiveActivityConfig()
+
         let attributes = LiveActivityAttributes(
           name: "ExpoLiveActivity",
           backgroundColor: config.backgroundColor,
@@ -186,8 +209,22 @@ public class ExpoLiveActivityModule: Module {
           progressViewTint: config.progressViewTint,
           progressViewLabelColor: config.progressViewLabelColor,
           deepLinkUrl: config.deepLinkUrl,
-          timerType: config.timerType == .digital ? .digital : .circular
+          timerType: config.timerType == .digital ? .digital : .circular,
+          padding: config.padding,
+          paddingDetails: config.paddingDetails.map {
+            LiveActivityAttributes.PaddingDetails(
+              top: $0.top,
+              bottom: $0.bottom,
+              left: $0.left,
+              right: $0.right,
+              vertical: $0.vertical,
+              horizontal: $0.horizontal
+            )
+          },
+          imagePosition: config.imagePosition,
+          imageSize: config.imageSize
         )
+
         let initialState = LiveActivityAttributes.ContentState(
           title: state.title,
           subtitle: state.subtitle,
@@ -208,20 +245,19 @@ public class ExpoLiveActivityModule: Module {
         }
 
         return activity.id
-      } catch let error {
-        print("Error with live activity: \(error)")
-        throw LiveActivityErrors.unexpectedError(error)
-
+      } catch {
+        throw UnexpectedErrorException(error)
       }
     }
 
     Function("stopActivity") { (activityId: String, state: LiveActivityState) in
-      guard #available(iOS 16.2, *) else { throw LiveActivityErrors.unsupportedOS }
+      guard #available(iOS 16.2, *) else { throw UnsupportedOSException("16.2") }
+
       guard
         let activity = Activity<LiveActivityAttributes>.activities.first(where: {
           $0.id == activityId
         })
-      else { throw LiveActivityErrors.notFound }
+      else { throw ActivityNotFoundException(activityId) }
 
       Task {
         print("Stopping activity with id: \(activityId)")
@@ -240,12 +276,15 @@ public class ExpoLiveActivityModule: Module {
     }
 
     Function("updateActivity") { (activityId: String, state: LiveActivityState) in
-      guard #available(iOS 16.2, *) else { throw LiveActivityErrors.unsupportedOS }
+      guard #available(iOS 16.2, *) else {
+        throw UnsupportedOSException("16.2")
+      }
+
       guard
         let activity = Activity<LiveActivityAttributes>.activities.first(where: {
           $0.id == activityId
         })
-      else { throw LiveActivityErrors.notFound }
+      else { throw ActivityNotFoundException(activityId) }
 
       Task {
         print("Updating activity with id: \(activityId)")

package/ios/Helpers.swift

@@ -1,15 +1,9 @@
-//
-//  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 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)

package/ios/LiveActivityAttributes.swift

@@ -1,15 +1,8 @@
-//
-//  LiveActivityAttributes.swift
-//  ExpoLiveActivity
-//
-//  Created by Anna Olak on 03/06/2025.
-//
-
 import ActivityKit
 import Foundation
 
 struct LiveActivityAttributes: ActivityAttributes {
-  public struct ContentState: Codable, Hashable {
+  struct ContentState: Codable, Hashable {
     var title: String
     var subtitle: String?
     var timerEndDateInMilliseconds: Double?
@@ -26,9 +19,22 @@ struct LiveActivityAttributes: ActivityAttributes {
   var progressViewLabelColor: String?
   var deepLinkUrl: String?
   var timerType: DynamicIslandTimerType?
+  var padding: Int?
+  var paddingDetails: PaddingDetails?
+  var imagePosition: String?
+  var imageSize: String?
 
   enum DynamicIslandTimerType: String, Codable {
     case circular
     case digital
   }
+
+  struct PaddingDetails: Codable, Hashable {
+    var top: Int?
+    var bottom: Int?
+    var left: Int?
+    var right: Int?
+    var vertical: Int?
+    var horizontal: Int?
+  }
 }

package/ios/LiveActivityExceptions.swift

@@ -0,0 +1,25 @@
+import ExpoModulesCore
+
+final class UnsupportedOSException: GenericException<String> {
+  override var reason: String {
+    "Live Activities require iOS \(param) or later. Current version: \(UIDevice.current.systemVersion)"
+  }
+}
+
+final class ActivityNotFoundException: GenericException<String> {
+  override var reason: String {
+    "Activity with ID '\(param)' not found"
+  }
+}
+
+final class LiveActivitiesNotEnabledException: Exception {
+  override var reason: String {
+    "Live Activities are currently disabled - enable them in Settings > Face ID & Passcode > Live Activities and Settings > [Your App] > Live Activities"
+  }
+}
+
+final class UnexpectedErrorException: GenericException<Error> {
+  override var reason: String {
+    "An unexpected error occurred: \(param.localizedDescription)"
+  }
+}

package/ios-files/Color+hex.swift

@@ -8,7 +8,7 @@ extension Color {
       cString.remove(at: cString.startIndex)
     }
 
-    if (cString.count) != 6 && (cString.count) != 8 {
+    if (cString.count) != 6, (cString.count) != 8 {
       self.init(.white)
       return
     }
@@ -19,17 +19,17 @@ extension Color {
     if (cString.count) == 8 {
       self.init(
         .sRGB,
-        red: Double((rgbValue >> 24) & 0xff) / 255,
-        green: Double((rgbValue >> 16) & 0xff) / 255,
-        blue: Double((rgbValue >> 08) & 0xff) / 255,
-        opacity: Double((rgbValue >> 00) & 0xff) / 255
+        red: Double((rgbValue >> 24) & 0xFF) / 255,
+        green: Double((rgbValue >> 16) & 0xFF) / 255,
+        blue: Double((rgbValue >> 08) & 0xFF) / 255,
+        opacity: Double((rgbValue >> 00) & 0xFF) / 255
       )
     } else {
       self.init(
         .sRGB,
-        red: Double((rgbValue >> 16) & 0xff) / 255,
-        green: Double((rgbValue >> 08) & 0xff) / 255,
-        blue: Double((rgbValue >> 00) & 0xff) / 255,
+        red: Double((rgbValue >> 16) & 0xFF) / 255,
+        green: Double((rgbValue >> 08) & 0xFF) / 255,
+        blue: Double((rgbValue >> 00) & 0xFF) / 255,
         opacity: 1
       )
     }

package/ios-files/Date+toTimerInterval.swift

@@ -1,13 +1,7 @@
-//
-//  Date+toTimerInterval.swift
-//  
-//
-//  Created by Artur Bilski on 04/08/2025.
-//
 import SwiftUI
 
 extension Date {
   static func toTimerInterval(miliseconds: Double) -> ClosedRange<Self> {
-      Self.now...max(Self.now, Date(timeIntervalSince1970: miliseconds / 1000))
+    now ... max(now, Date(timeIntervalSince1970: miliseconds / 1000))
   }
 }

package/ios-files/Image+dynamic.swift

@@ -1,9 +1,3 @@
-//
-//  Image+dynamic.swift
-//  
-//
-//  Created by Artur Bilski on 04/08/2025.
-//
 import SwiftUI
 
 extension Image {

package/ios-files/LiveActivityView.swift

@@ -1,10 +1,3 @@
-//
-//  LiveActivityView.swift
-//  ExpoLiveActivity
-//
-//  Created by Anna Olak on 03/06/2025.
-//
-
 import SwiftUI
 import WidgetKit
 
@@ -31,8 +24,45 @@ import WidgetKit
     }
 
     var body: some View {
+      let defaultPadding = 24
+
+      let top = CGFloat(
+        attributes.paddingDetails?.top
+          ?? attributes.paddingDetails?.vertical
+          ?? attributes.padding
+          ?? defaultPadding
+      )
+
+      let bottom = CGFloat(
+        attributes.paddingDetails?.bottom
+          ?? attributes.paddingDetails?.vertical
+          ?? attributes.padding
+          ?? defaultPadding
+      )
+
+      let leading = CGFloat(
+        attributes.paddingDetails?.left
+          ?? attributes.paddingDetails?.horizontal
+          ?? attributes.padding
+          ?? defaultPadding
+      )
+
+      let trailing = CGFloat(
+        attributes.paddingDetails?.right
+          ?? attributes.paddingDetails?.horizontal
+          ?? attributes.padding
+          ?? defaultPadding
+      )
+
       VStack(alignment: .leading) {
         HStack(alignment: .center) {
+          if attributes.imagePosition == "left" {
+            if let imageName = contentState.imageName {
+              resizableImage(imageName: imageName)
+                .applyImageSize(attributes.imageSize)
+            }
+          }
+
           VStack(alignment: .leading, spacing: 2) {
             Text(contentState.title)
               .font(.title2)
@@ -44,27 +74,42 @@ import WidgetKit
                 .font(.title3)
                 .modifier(ConditionalForegroundViewModifier(color: attributes.subtitleColor))
             }
-          }
 
-          Spacer()
+            if attributes.imageSize == "fullHeight" {
+              if let date = contentState.timerEndDateInMilliseconds {
+                ProgressView(timerInterval: Date.toTimerInterval(miliseconds: date))
+                  .tint(progressViewTint)
+                  .modifier(ConditionalForegroundViewModifier(color: attributes.progressViewLabelColor))
+              } else if let progress = contentState.progress {
+                ProgressView(value: progress)
+                  .tint(progressViewTint)
+                  .modifier(ConditionalForegroundViewModifier(color: attributes.progressViewLabelColor))
+              }
+            }
+          }
 
-          if let imageName = contentState.imageName {
-            resizableImage(imageName: imageName)
-              .frame(maxHeight: 64)
+          if attributes.imagePosition == "right" || attributes.imagePosition == nil {
+            Spacer()
+            if let imageName = contentState.imageName {
+              resizableImage(imageName: imageName)
+                .applyImageSize(attributes.imageSize)
+            }
           }
         }
 
-        if let date = contentState.timerEndDateInMilliseconds {
-          ProgressView(timerInterval: Date.toTimerInterval(miliseconds: date))
-            .tint(progressViewTint)
-            .modifier(ConditionalForegroundViewModifier(color: attributes.progressViewLabelColor))
-        } else if let progress = contentState.progress {
-          ProgressView(value: progress)
-            .tint(progressViewTint)
-            .modifier(ConditionalForegroundViewModifier(color: attributes.progressViewLabelColor))
+        if attributes.imageSize != "fullHeight" {
+          if let date = contentState.timerEndDateInMilliseconds {
+            ProgressView(timerInterval: Date.toTimerInterval(miliseconds: date))
+              .tint(progressViewTint)
+              .modifier(ConditionalForegroundViewModifier(color: attributes.progressViewLabelColor))
+          } else if let progress = contentState.progress {
+            ProgressView(value: progress)
+              .tint(progressViewTint)
+              .modifier(ConditionalForegroundViewModifier(color: attributes.progressViewLabelColor))
+          }
         }
       }
-      .padding(24)
+      .padding(EdgeInsets(top: top, leading: leading, bottom: bottom, trailing: trailing))
     }
   }
 

package/ios-files/LiveActivityWidget.swift

@@ -1,16 +1,9 @@
-//
-//  LiveActivityWidget.swift
-//  LiveActivity
-//
-//  Created by Anna Olak on 02/06/2025.
-//
-
 import ActivityKit
 import SwiftUI
 import WidgetKit
 
 struct LiveActivityAttributes: ActivityAttributes {
-  public struct ContentState: Codable, Hashable {
+  struct ContentState: Codable, Hashable {
     var title: String
     var subtitle: String?
     var timerEndDateInMilliseconds: Double?
@@ -27,11 +20,24 @@ struct LiveActivityAttributes: ActivityAttributes {
   var progressViewLabelColor: String?
   var deepLinkUrl: String?
   var timerType: DynamicIslandTimerType?
+  var padding: Int?
+  var paddingDetails: PaddingDetails?
+  var imagePosition: String?
+  var imageSize: String?
 
   enum DynamicIslandTimerType: String, Codable {
     case circular
     case digital
   }
+
+  struct PaddingDetails: Codable, Hashable {
+    var top: Int?
+    var bottom: Int?
+    var left: Int?
+    var right: Int?
+    var vertical: Int?
+    var horizontal: Int?
+  }
 }
 
 struct LiveActivityWidget: Widget {
@@ -60,9 +66,11 @@ struct LiveActivityWidget: Widget {
         }
         DynamicIslandExpandedRegion(.bottom) {
           if let date = context.state.timerEndDateInMilliseconds {
-            dynamicIslandExpandedBottom(endDate: date, progressViewTint: context.attributes.progressViewTint)
-              .padding(.horizontal, 5)
-              .applyWidgetURL(from: context.attributes.deepLinkUrl)
+            dynamicIslandExpandedBottom(
+              endDate: date, progressViewTint: context.attributes.progressViewTint
+            )
+            .padding(.horizontal, 5)
+            .applyWidgetURL(from: context.attributes.deepLinkUrl)
           }
         }
       } compactLeading: {

package/ios-files/LiveActivityWidgetBundle.swift

@@ -1,10 +1,3 @@
-//
-//  LiveActivityWidgetBundle.swift
-//  LiveActivity
-//
-//  Created by Anna Olak on 02/06/2025.
-//
-
 import SwiftUI
 import WidgetKit
 

package/ios-files/View+applyIfPresent.swift

@@ -1,10 +1,3 @@
-//
-//  View+applyIfPresent.swift
-//
-//
-//  Created by Artur Bilski on 05/08/2025.
-//
-
 import SwiftUI
 
 extension View {

package/ios-files/View+applyWidgetURL.swift

@@ -1,10 +1,3 @@
-//
-//  View+applyWidgetURL.swift
-//
-//
-//  Created by Artur Bilski on 05/08/2025.
-//
-
 import SwiftUI
 
 private let cachedScheme: String? = {
@@ -23,7 +16,9 @@ extension View {
   @ViewBuilder
   func applyWidgetURL(from urlString: String?) -> some View {
     applyIfPresent(urlString) { view, string in
-      applyIfPresent(cachedScheme) { view, scheme in view.widgetURL(URL(string: scheme + "://" + string)) }
+      applyIfPresent(cachedScheme) { view, scheme in
+        view.widgetURL(URL(string: scheme + "://" + string))
+      }
     }
   }
 }

package/ios-files/ViewHelpers.swift

@@ -1,9 +1,3 @@
-//
-//  ViewHelpers.swift
-//  
-//
-//  Created by Artur Bilski on 04/08/2025.
-//
 import SwiftUI
 
 func resizableImage(imageName: String) -> some View {
@@ -11,3 +5,15 @@ func resizableImage(imageName: String) -> some View {
     .resizable()
     .scaledToFit()
 }
+
+extension View {
+  @ViewBuilder
+  func applyImageSize(_ size: String?) -> some View {
+    switch size {
+    case "fullHeight":
+      frame(maxHeight: .infinity)
+    default:
+      frame(maxHeight: 64)
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-live-activity",
-  "version": "0.4.0",
+  "version": "0.4.1-alpha1",
   "description": "A module for adding Live Activity to a React Native app for iOS.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -15,7 +15,8 @@
     "prepare": "expo-module prepare && rm .eslintrc.js",
     "prepublishOnly": "expo-module prepublishOnly",
     "expo-module": "expo-module",
-    "open:ios": "xed example/ios"
+    "open:ios": "xed example/ios",
+    "typecheck": "tsc"
   },
   "keywords": [
     "react-native",
@@ -29,10 +30,7 @@
     "Anna Olak <anna.olak@swmansion.com> (https://github.com/anna1901)",
     "Artur Bilski <artur.bilski@swmansion.com> (https://github.com/arthwood)"
   ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/software-mansion-labs/expo-live-activity.git"
-  },
+  "repository": "https://github.com/software-mansion-labs/expo-live-activity",
   "bugs": {
     "url": "https://github.com/software-mansion-labs/expo-live-activity/issues"
   },

package/plugin/build/index.js

@@ -22,7 +22,7 @@ const withWidgetsAndLiveActivities = (config, props) => {
         },
     };
     config = (0, config_plugins_1.withPlugins)(config, [
-        [withPlist_1.default, { targetName }],
+        withPlist_1.default,
         [
             withXcode_1.withXcode,
             {

package/plugin/build/withPlist.d.ts

@@ -1,5 +1,3 @@
 import { ConfigPlugin } from '@expo/config-plugins';
-declare const withPlist: ConfigPlugin<{
-    targetName: string;
-}>;
+declare const withPlist: ConfigPlugin;
 export default withPlist;

package/plugin/build/withPlist.js

@@ -1,25 +1,10 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_plugins_1 = require("@expo/config-plugins");
-const plist_1 = __importDefault(require("@expo/plist"));
-const fs_1 = require("fs");
-const path_1 = require("path");
-const withPlist = (expoConfig, { targetName }) => (0, config_plugins_1.withInfoPlist)(expoConfig, (plistConfig) => {
+const withPlist = (expoConfig) => (0, config_plugins_1.withInfoPlist)(expoConfig, (plistConfig) => {
     const scheme = typeof expoConfig.scheme === 'string' ? expoConfig.scheme : expoConfig.ios?.bundleIdentifier;
-    if (scheme) {
-        const targetPath = (0, path_1.join)(plistConfig.modRequest.platformProjectRoot, targetName);
-        const filePath = (0, path_1.join)(targetPath, 'Info.plist');
-        const content = plist_1.default.parse((0, fs_1.readFileSync)(filePath, 'utf8'));
-        content.CFBundleURLTypes = [
-            {
-                CFBundleURLSchemes: [scheme],
-            },
-        ];
-        (0, fs_1.writeFileSync)(filePath, plist_1.default.build(content));
-    }
+    if (scheme)
+        plistConfig.modResults.CFBundleURLTypes = [{ CFBundleURLSchemes: [scheme] }];
     return plistConfig;
 });
 exports.default = withPlist;

package/plugin/src/index.ts

@@ -22,7 +22,7 @@ const withWidgetsAndLiveActivities: LiveActivityConfigPlugin = (config, props) =
   }
 
   config = withPlugins(config, [
-    [withPlist, { targetName }],
+    withPlist,
     [
       withXcode,
       {

package/plugin/src/withPlist.ts

@@ -1,26 +1,9 @@
-import { ConfigPlugin, InfoPlist, withInfoPlist } from '@expo/config-plugins'
-import plist from '@expo/plist'
-import { readFileSync, writeFileSync } from 'fs'
-import { join as joinPath } from 'path'
+import { ConfigPlugin, withInfoPlist } from '@expo/config-plugins'
 
-const withPlist: ConfigPlugin<{ targetName: string }> = (expoConfig, { targetName }) =>
+const withPlist: ConfigPlugin = (expoConfig) =>
   withInfoPlist(expoConfig, (plistConfig) => {
     const scheme = typeof expoConfig.scheme === 'string' ? expoConfig.scheme : expoConfig.ios?.bundleIdentifier
-
-    if (scheme) {
-      const targetPath = joinPath(plistConfig.modRequest.platformProjectRoot, targetName)
-      const filePath = joinPath(targetPath, 'Info.plist')
-      const content = plist.parse(readFileSync(filePath, 'utf8')) as InfoPlist
-
-      content.CFBundleURLTypes = [
-        {
-          CFBundleURLSchemes: [scheme],
-        },
-      ]
-
-      writeFileSync(filePath, plist.build(content))
-    }
-
+    if (scheme) plistConfig.modResults.CFBundleURLTypes = [{ CFBundleURLSchemes: [scheme] }]
     return plistConfig
   })
 

package/src/index.ts

@@ -34,6 +34,21 @@ export type NativeLiveActivityState = {
   dynamicIslandImageName?: string
 }
 
+export type Padding =
+  | {
+      top?: number
+      bottom?: number
+      left?: number
+      right?: number
+      vertical?: number
+      horizontal?: number
+    }
+  | number
+
+export type ImagePosition = 'left' | 'right'
+
+export type ImageSize = 'fullHeight' | 'default'
+
 export type LiveActivityConfig = {
   backgroundColor?: string
   titleColor?: string
@@ -42,6 +57,9 @@ export type LiveActivityConfig = {
   progressViewLabelColor?: string
   deepLinkUrl?: string
   timerType?: DynamicIslandTimerType
+  padding?: Padding
+  imagePosition?: ImagePosition
+  imageSize?: ImageSize
 }
 
 export type ActivityTokenReceivedEvent = {
@@ -82,7 +100,17 @@ function assertIOS(name: string) {
  * @returns {string} The identifier of the started activity or undefined if creating live activity failed.
  */
 export function startActivity(state: LiveActivityState, config?: LiveActivityConfig): Voidable<string> {
-  if (assertIOS('startActivity')) return ExpoLiveActivityModule.startActivity(state, config)
+  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))
 }
 
 /**