customerio-expo-plugin 3.1.0 → 3.2.0

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

@@ -1,4 +1,5 @@
 import type { ExpoConfig } from '@expo/config-types';
-import type { CustomerIOPluginOptions } from './types/cio-types';
+import type { CustomerIOPluginOptions, LocationTrackingMode, NativeSDKConfig } from './types/cio-types';
+export type { LocationTrackingMode, NativeSDKConfig };
 declare function withCustomerIOPlugin(config: ExpoConfig, props: CustomerIOPluginOptions): ExpoConfig;
 export default withCustomerIOPlugin;

package/plugin/lib/typescript/ios/withCIOIos.d.ts

@@ -1,3 +1,3 @@
 import type { ExpoConfig } from '@expo/config-types';
-import type { CustomerIOPluginOptionsIOS, NativeSDKConfig } from '../types/cio-types';
-export declare function withCIOIos(config: ExpoConfig, sdkConfig?: NativeSDKConfig, props?: CustomerIOPluginOptionsIOS): ExpoConfig;
+import type { CustomerIOPluginOptionsIOS, CustomerIOPluginLocationOptions, NativeSDKConfig } from '../types/cio-types';
+export declare function withCIOIos(config: ExpoConfig, sdkConfig?: NativeSDKConfig, props?: CustomerIOPluginOptionsIOS, location?: CustomerIOPluginLocationOptions): ExpoConfig;

package/plugin/lib/typescript/ios/withCIOIosSwift.d.ts

@@ -1,3 +1,3 @@
 import type { ExpoConfig } from '@expo/config-types';
-import type { CustomerIOPluginOptionsIOS, NativeSDKConfig } from '../types/cio-types';
-export declare const withCIOIosSwift: (configOuter: ExpoConfig, sdkConfig?: NativeSDKConfig, props?: CustomerIOPluginOptionsIOS) => ExpoConfig;
+import type { CustomerIOPluginOptionsIOS, CustomerIOPluginLocationOptions, NativeSDKConfig } from '../types/cio-types';
+export declare const withCIOIosSwift: (configOuter: ExpoConfig, sdkConfig?: NativeSDKConfig, props?: CustomerIOPluginOptionsIOS, location?: CustomerIOPluginLocationOptions) => ExpoConfig;

package/plugin/lib/typescript/ios/withXcodeProject.d.ts

@@ -1,3 +1,10 @@
 import type { ConfigPlugin } from '@expo/config-plugins';
+import { type InjectCIOPodfileOptions } from '../helpers/utils/injectCIOPodfileCode';
 import type { CustomerIOPluginOptionsIOS } from '../types/cio-types';
-export declare const withCioXcodeProject: ConfigPlugin<CustomerIOPluginOptionsIOS>;
+export type WithCioXcodeProjectOptions = {
+    /** Options for Podfile host app snippet (location subspec, etc.) */
+    podfileOptions?: InjectCIOPodfileOptions;
+};
+/** Props for the CIO Xcode project mod; push options are optional when only location is enabled. */
+export type WithCioXcodeProjectProps = Partial<CustomerIOPluginOptionsIOS> & WithCioXcodeProjectOptions;
+export declare const withCioXcodeProject: ConfigPlugin<WithCioXcodeProjectProps>;

package/plugin/lib/typescript/types/cio-types.d.ts

@@ -76,6 +76,12 @@ export type CustomerIOPluginOptionsAndroid = {
      */
     disableAndroid16Support?: boolean;
 };
+/**
+ * Location tracking mode for the Customer.io SDK location module.
+ * Location is off by default. Only used when location is enabled (plugin option location.enabled: true).
+ * @public
+ */
+export type LocationTrackingMode = 'OFF' | 'MANUAL' | 'ON_APP_START';
 /**
  * SDK configuration options for auto initialization
  * @public
@@ -89,6 +95,23 @@ export type NativeSDKConfig = {
     logLevel?: 'none' | 'error' | 'info' | 'debug';
     siteId?: string;
     migrationSiteId?: string;
+    /**
+     * Location module config. Location is off by default; only applied when plugin option location.enabled is true.
+     * trackingMode: 'MANUAL' (host app controls when location is captured, default),
+     * 'ON_APP_START' (SDK captures once per launch when app becomes active), or 'OFF'.
+     */
+    location?: {
+        trackingMode?: LocationTrackingMode;
+    };
+};
+/**
+ * Location is off by default. When true, enables the Customer.io SDK location native module (iOS Podfile location subspec,
+ * Android gradle.properties flag). Permissions and privacy keys (Info.plist, AndroidManifest)
+ * remain the host app's responsibility.
+ * @public
+ */
+export type CustomerIOPluginLocationOptions = {
+    enabled?: boolean;
 };
 /**
  * Combined plugin options for both iOS and Android platforms
@@ -98,6 +121,11 @@ export type CustomerIOPluginOptions = {
     config?: NativeSDKConfig;
     android: CustomerIOPluginOptionsAndroid;
     ios: CustomerIOPluginOptionsIOS;
+    /**
+     * Location is off by default. When location.enabled is true, the plugin adds SDK build-time setup (Podfile location subspec,
+     * gradle.properties). Host apps must add their own location permissions and privacy usage strings.
+     */
+    location?: CustomerIOPluginLocationOptions;
 };
 /**
  * Rich push configuration used to initialize Notification Service Extension (NSE) on the native side

package/plugin/src/android/withCIOAndroid.ts

@@ -1,9 +1,14 @@
 import type { ExpoConfig } from '@expo/config-types';
 
-import type { CustomerIOPluginOptionsAndroid, NativeSDKConfig } from '../types/cio-types';
+import type {
+  CustomerIOPluginOptionsAndroid,
+  CustomerIOPluginLocationOptions,
+  NativeSDKConfig,
+} from '../types/cio-types';
 import { withAndroidManifestUpdates } from './withAndroidManifestUpdates';
 import { withAppGoogleServices } from './withAppGoogleServices';
 import { withGoogleServicesJSON } from './withGoogleServicesJSON';
+import { withLocationGradleProperties } from './withLocationGradleProperties';
 import { withMainApplicationModifications } from './withMainApplicationModifications';
 import { withNotificationChannelMetadata } from './withNotificationChannelMetadata';
 import { withProjectBuildGradle } from './withProjectBuildGradle';
@@ -14,6 +19,7 @@ export function withCIOAndroid(
   config: ExpoConfig,
   sdkConfig?: NativeSDKConfig,
   props?: CustomerIOPluginOptionsAndroid,
+  location?: CustomerIOPluginLocationOptions,
 ): ExpoConfig {
   // Only run notification setup if props are provided
   if (props) {
@@ -30,7 +36,7 @@ export function withCIOAndroid(
 
   // Add auto initialization if sdkConfig is provided
   if (sdkConfig) {
-    config = withMainApplicationModifications(config, sdkConfig);
+    config = withMainApplicationModifications(config, { sdkConfig, location });
   }
 
   // Update project strings for user agent metadata
@@ -40,5 +46,10 @@ export function withCIOAndroid(
   // This prevents androidx versions that require API 36 from being pulled in
   config = withProjectBuildGradle(config, props);
 
+  // Enable SDK location module when location.enabled is true
+  if (location?.enabled === true) {
+    config = withLocationGradleProperties(config, { location });
+  }
+
   return config;
 }

package/plugin/src/android/withLocationGradleProperties.ts

@@ -0,0 +1,41 @@
+import type { ConfigPlugin } from '@expo/config-plugins';
+import { withGradleProperties } from '@expo/config-plugins';
+import type { PropertiesItem } from '@expo/config-plugins/build/android/Properties';
+
+import type { CustomerIOPluginLocationOptions } from '../types/cio-types';
+
+const CUSTOMERIO_LOCATION_ENABLED_KEY = 'customerio_location_enabled';
+
+/**
+ * Adds or updates customerio_location_enabled in android/gradle.properties when location.enabled is true.
+ * The Customer.io React Native SDK reads this to enable the location native module.
+ */
+export const withLocationGradleProperties: ConfigPlugin<{
+  location?: CustomerIOPluginLocationOptions;
+}> = (config, props) => {
+  if (props?.location?.enabled !== true) {
+    return config;
+  }
+
+  return withGradleProperties(config, (config) => {
+    const items = config.modResults as PropertiesItem[];
+    const existingIndex = items.findIndex(
+      (item) => item.type === 'property' && item.key === CUSTOMERIO_LOCATION_ENABLED_KEY
+    );
+
+    const newItem: PropertiesItem = {
+      type: 'property',
+      key: CUSTOMERIO_LOCATION_ENABLED_KEY,
+      value: 'true',
+    };
+
+    if (existingIndex >= 0) {
+      items[existingIndex] = newItem;
+    } else {
+      items.push(newItem);
+    }
+
+    config.modResults = items;
+    return config;
+  });
+};

package/plugin/src/android/withMainApplicationModifications.ts

@@ -4,24 +4,45 @@ import type { ApplicationProjectFile } from '@expo/config-plugins/build/android/
 import { CIO_MAINAPPLICATION_ONCREATE_REGEX, CIO_NATIVE_SDK_INITIALIZE_CALL, CIO_NATIVE_SDK_INITIALIZE_SNIPPET } from '../helpers/constants/android';
 import { PLATFORM } from '../helpers/constants/common';
 import { patchNativeSDKInitializer } from '../helpers/utils/patchPluginNativeCode';
-import type { NativeSDKConfig } from '../types/cio-types';
+import type {
+  CustomerIOPluginLocationOptions,
+  NativeSDKConfig,
+} from '../types/cio-types';
 import { addCodeToMethod, addImportToFile, copyTemplateFile } from '../utils/android';
 import { logger } from '../utils/logger';
 
-export const withMainApplicationModifications: ConfigPlugin<NativeSDKConfig> = (configOuter, sdkConfig) => {
+type MainApplicationModParams = {
+  sdkConfig: NativeSDKConfig;
+  location?: CustomerIOPluginLocationOptions;
+};
+
+export const withMainApplicationModifications: ConfigPlugin<MainApplicationModParams> = (configOuter, { sdkConfig, location }) => {
   return withMainApplication(configOuter, async (config) => {
-    const content = setupCustomerIOSDKInitializer(config, sdkConfig);
+    const content = setupCustomerIOSDKInitializer(config, sdkConfig, location);
     config.modResults.contents = content;
     return config;
   });
 };
 
+/**
+ * Build location options for native initializer from plugin config.
+ * trackingMode comes from config.location.trackingMode (only used when location.enabled is true).
+ */
+const getLocationInitOptions = (
+  location?: CustomerIOPluginLocationOptions,
+  sdkConfig?: NativeSDKConfig
+) => ({
+  enabled: location?.enabled === true,
+  trackingMode: sdkConfig?.location?.trackingMode,
+});
+
 /**
  * Setup CustomerIOSDKInitializer for Android auto initialization
  */
 const setupCustomerIOSDKInitializer = (
   config: ExportedConfigWithProps<ApplicationProjectFile>,
   sdkConfig: NativeSDKConfig,
+  location?: CustomerIOPluginLocationOptions,
 ): string => {
   const SDK_INITIALIZER_CLASS = 'CustomerIOSDKInitializer';
   const SDK_INITIALIZER_PACKAGE = 'io.customer.sdk.expo';
@@ -29,12 +50,13 @@ const setupCustomerIOSDKInitializer = (
   const SDK_INITIALIZER_FILE = `${SDK_INITIALIZER_CLASS}.kt`;
   const SDK_INITIALIZER_IMPORT = `import ${SDK_INITIALIZER_PACKAGE}.${SDK_INITIALIZER_CLASS}`;
 
+  const locationOptions = getLocationInitOptions(location, sdkConfig);
   let content = config.modResults.contents;
 
   try {
     // Always regenerate the CustomerIOSDKInitializer file to reflect config changes
     copyTemplateFile(config, SDK_INITIALIZER_FILE, SDK_INITIALIZER_PACKAGE, (content) =>
-      patchNativeSDKInitializer(content, PLATFORM.ANDROID, sdkConfig)
+      patchNativeSDKInitializer(content, PLATFORM.ANDROID, sdkConfig, locationOptions)
     );
     // Add import if not already present
     content = addImportToFile(content, SDK_INITIALIZER_IMPORT);

package/plugin/src/helpers/native-files/android/CustomerIOSDKInitializer.kt

@@ -7,6 +7,7 @@ import io.customer.messaginginapp.ModuleMessagingInApp
 import io.customer.messagingpush.MessagingPushModuleConfig
 import io.customer.messagingpush.ModuleMessagingPushFCM
 import io.customer.reactnative.sdk.messaginginapp.ReactInAppEventListener
+{{LOCATION_MODULE_IMPORT}}
 import io.customer.sdk.CustomerIOBuilder
 import io.customer.sdk.core.util.CioLogLevel
 import io.customer.sdk.data.model.Region
@@ -41,6 +42,7 @@ object CustomerIOSDKInitializer {
                 MessagingPushModuleConfig.Builder().build()
             )
         )
+        {{LOCATION_MODULE_INIT}}
 
         build()
     }

package/plugin/src/helpers/native-files/ios/CustomerIOSDKInitializer.swift

@@ -1,6 +1,7 @@
 import CioDataPipelines
 import CioInternalCommon
 import CioMessagingInApp
+{{LOCATION_MODULE_IMPORT}}
 
 class CustomerIOSDKInitializer {
     static func initialize() {
@@ -23,6 +24,7 @@ class CustomerIOSDKInitializer {
         setIfDefined(value: {{SCREEN_VIEW_USE}}, thenPassItTo: builder.screenViewUse) { ScreenView.getScreenView($0) }
         setIfDefined(value: {{MIGRATION_SITE_ID}}, thenPassItTo: builder.migrationSiteId)
 
+        {{LOCATION_MODULE_INIT}}
         CustomerIO.initialize(withConfig: builder.build())
 
         if let siteId = siteId {

package/plugin/src/helpers/utils/injectCIOPodfileCode.ts

@@ -4,9 +4,40 @@ import { getRelativePathToRNSDK } from '../constants/ios';
 import { injectCodeByRegex } from './codeInjection';
 import { FileManagement } from './fileManagement';
 
+export type InjectCIOPodfileOptions = {
+  /** When true, add the location subspec. When false/omit, use single push subspec only. */
+  locationEnabled?: boolean;
+  /** When false and locationEnabled, inject only :subspecs => ['location']. When true, use push + location. */
+  hasPush?: boolean;
+};
+
+/** Builds the host app pod line for the Podfile (single subspec or :subspecs with location). Exported for tests. */
+export function buildHostAppPodSnippet(
+  iosPath: string,
+  isFcmPushProvider: boolean,
+  options?: InjectCIOPodfileOptions
+): string {
+  const path = getRelativePathToRNSDK(iosPath);
+  const locationEnabled = options?.locationEnabled === true;
+  const hasPush = options?.hasPush !== false;
+
+  if (!locationEnabled) {
+    const subspec = isFcmPushProvider ? 'fcm' : 'apn';
+    return `pod 'customerio-reactnative/${subspec}', :path => '${path}'`;
+  }
+
+  if (!hasPush) {
+    return `pod 'customerio-reactnative', :subspecs => ['location'], :path => '${path}'`;
+  }
+
+  const pushSubspec = isFcmPushProvider ? 'fcm' : 'apn';
+  return `pod 'customerio-reactnative', :subspecs => ['${pushSubspec}', 'location'], :path => '${path}'`;
+}
+
 export async function injectCIOPodfileCode(
   iosPath: string,
-  isFcmPushProvider: boolean
+  isFcmPushProvider: boolean,
+  options?: InjectCIOPodfileOptions
 ) {
   const blockStart = '# --- CustomerIO Host App START ---';
   const blockEnd = '# --- CustomerIO Host App END ---';
@@ -21,10 +52,11 @@ export async function injectCIOPodfileCode(
     // Find that line in the Podfile and then we will insert our code above that line.
     const lineInPodfileToInjectSnippetBefore = /post_install do \|installer\|/;
 
+    const podLine = buildHostAppPodSnippet(iosPath, isFcmPushProvider, options);
+
     const snippetToInjectInPodfile = `
 ${blockStart}
-  pod 'customerio-reactnative/${isFcmPushProvider ? 'fcm' : 'apn'
-      }', :path => '${getRelativePathToRNSDK(iosPath)}'
+  ${podLine}
 ${blockEnd}
 `.trim();
 

package/plugin/src/helpers/utils/patchLocationCode.ts

@@ -0,0 +1,80 @@
+import type { LocationTrackingMode } from '../../types/cio-types';
+import { PLATFORM, type Platform } from '../constants/common';
+
+const VALID_TRACKING_MODES: LocationTrackingMode[] = ['OFF', 'MANUAL', 'ON_APP_START'];
+
+/** Options for location module in generated native initializer */
+export type LocationInitOptions = {
+  enabled: boolean;
+  trackingMode?: LocationTrackingMode;
+};
+
+function normalizeTrackingMode(
+  rawMode: string | undefined
+): LocationTrackingMode {
+  const upper = rawMode?.toUpperCase();
+  return upper && VALID_TRACKING_MODES.includes(upper as LocationTrackingMode)
+    ? (upper as LocationTrackingMode)
+    : 'MANUAL';
+}
+
+/**
+ * Replaces {{LOCATION_MODULE_IMPORT}} and {{LOCATION_MODULE_INIT}} placeholders
+ * in SDK initializer template content for the given platform.
+ */
+export function patchLocationPlaceholders(
+  content: string,
+  platform: Platform,
+  locationOptions?: LocationInitOptions
+): string {
+  const locationEnabled = locationOptions?.enabled === true;
+  const trackingMode = normalizeTrackingMode(locationOptions?.trackingMode);
+
+  if (platform === PLATFORM.ANDROID) {
+    if (locationEnabled) {
+      return content
+        .replace(
+          /\{\{LOCATION_MODULE_IMPORT\}\}/g,
+          `import io.customer.location.LocationModuleConfig
+import io.customer.location.LocationTrackingMode
+import io.customer.location.ModuleLocation
+`
+        )
+        .replace(
+          /\{\{LOCATION_MODULE_INIT\}\}/g,
+          `if (io.customer.reactnative.sdk.BuildConfig.CIO_LOCATION_ENABLED) {
+            addCustomerIOModule(
+                ModuleLocation(
+                    LocationModuleConfig.Builder()
+                        .setLocationTrackingMode(LocationTrackingMode.${trackingMode})
+                        .build()
+                )
+            )
+        }
+        `
+        );
+    }
+    return content
+      .replace(/\n\{\{LOCATION_MODULE_IMPORT\}\}\n/g, '\n')
+      .replace(/\n\s*\{\{LOCATION_MODULE_INIT\}\}\n/g, '\n');
+  }
+
+  // iOS
+  if (locationEnabled) {
+    const modeSwift =
+      trackingMode === 'OFF'
+        ? '.off'
+        : trackingMode === 'ON_APP_START'
+          ? '.onAppStart'
+          : '.manual';
+    return content
+      .replace(/\{\{LOCATION_MODULE_IMPORT\}\}/g, 'import CioLocation\n')
+      .replace(
+        /\{\{LOCATION_MODULE_INIT\}\}/g,
+        `_ = builder.addModule(LocationModule(config: LocationConfig(mode: ${modeSwift})))`
+      );
+  }
+  return content
+    .replace(/\n\{\{LOCATION_MODULE_IMPORT\}\}\n/g, '\n')
+    .replace(/\n\s*\{\{LOCATION_MODULE_INIT\}\}\n/g, '\n\n');
+}

package/plugin/src/helpers/utils/patchPluginNativeCode.ts

@@ -2,6 +2,12 @@ import type { NativeSDKConfig } from '../../types/cio-types';
 import { getPluginVersion } from '../../utils/plugin';
 import { validateNativeSDKConfig } from '../../utils/validation';
 import { PLATFORM, type Platform } from '../constants/common';
+import {
+  type LocationInitOptions,
+  patchLocationPlaceholders,
+} from './patchLocationCode';
+
+export type { LocationInitOptions };
 
 /**
  * Shared utility function to perform common SDK config replacements
@@ -10,7 +16,8 @@ import { PLATFORM, type Platform } from '../constants/common';
 export function patchNativeSDKInitializer(
   rawContent: string,
   platform: Platform,
-  sdkConfig: NativeSDKConfig
+  sdkConfig: NativeSDKConfig,
+  locationOptions?: LocationInitOptions
 ): string {
   // Validate SDK configuration to ensure all fields are present and 
   // correct at the time of patching in prebuild
@@ -98,5 +105,7 @@ export function patchNativeSDKInitializer(
     (configValue) => `"${configValue}"`
   );
 
+  content = patchLocationPlaceholders(content, platform, locationOptions);
+
   return content;
 }

package/plugin/src/index.ts

@@ -3,7 +3,13 @@ import type { ExpoConfig } from '@expo/config-types';
 import { withCIOAndroid } from './android/withCIOAndroid';
 import { isExpoVersion53OrHigher } from './ios/utils';
 import { withCIOIos } from './ios/withCIOIos';
-import type { CustomerIOPluginOptions } from './types/cio-types';
+import type {
+  CustomerIOPluginOptions,
+  LocationTrackingMode,
+  NativeSDKConfig,
+} from './types/cio-types';
+
+export type { LocationTrackingMode, NativeSDKConfig };
 
 // Entry point for config plugin
 function withCustomerIOPlugin(
@@ -20,8 +26,8 @@ function withCustomerIOPlugin(
   }
 
   // Apply platform specific modifications
-  config = withCIOIos(config, props.config, props.ios);
-  config = withCIOAndroid(config, props.config, props.android);
+  config = withCIOIos(config, props.config, props.ios, props.location);
+  config = withCIOAndroid(config, props.config, props.android, props.location);
 
   return config;
 }

package/plugin/src/ios/withCIOIos.ts

@@ -2,6 +2,7 @@ import type { ExpoConfig } from '@expo/config-types';
 import type {
   CustomerIOPluginOptionsIOS,
   CustomerIOPluginPushNotificationOptions,
+  CustomerIOPluginLocationOptions,
   NativeSDKConfig,
 } from '../types/cio-types';
 import { mergeConfigWithEnvValues } from '../utils/config';
@@ -17,13 +18,15 @@ export function withCIOIos(
   config: ExpoConfig,
   sdkConfig?: NativeSDKConfig,
   props?: CustomerIOPluginOptionsIOS,
+  location?: CustomerIOPluginLocationOptions,
 ) {
   const isSwiftProject = isExpoVersion53OrHigher(config);
   const platformConfig = mergeDeprecatedPropertiesAndLogWarnings(props);
+  const locationEnabled = location?.enabled === true;
 
   if (platformConfig?.pushNotification) {
     if (isSwiftProject) {
-      config = withCIOIosSwift(config, sdkConfig, platformConfig);
+      config = withCIOIosSwift(config, sdkConfig, platformConfig, location);
     } else {
       // Auto initialization is only supported in Swift projects (Expo SDK 53+)
       // Legacy Objective-C projects only support push notifications
@@ -33,10 +36,28 @@ export function withCIOIos(
     platformConfig.pushNotification.env = platformConfig.pushNotification.env
       || mergeConfigWithEnvValues(platformConfig, sdkConfig);
     config = withCioNotificationsXcodeProject(config, platformConfig);
-    config = withCioXcodeProject(config, platformConfig);
+    config = withCioXcodeProject(config, {
+      ...platformConfig,
+      podfileOptions: {
+        locationEnabled,
+        hasPush: true,
+      },
+    });
     config = withGoogleServicesJsonFile(config, platformConfig);
   } else if (sdkConfig && isSwiftProject) {
-    config = withCIOIosSwift(config, sdkConfig, platformConfig);
+    config = withCIOIosSwift(config, sdkConfig, platformConfig, location);
+    if (locationEnabled) {
+      config = withCioXcodeProject(config, {
+        ...platformConfig,
+        podfileOptions: { locationEnabled: true, hasPush: false },
+      });
+    }
+  } else if (locationEnabled) {
+    // Location-only: no push, no config. Still add Podfile location subspec so CIO_LOCATION_ENABLED is set and native location code is included.
+    config = withCioXcodeProject(config, {
+      ...platformConfig,
+      podfileOptions: { locationEnabled: true, hasPush: false },
+    });
   }
 
   return config;

package/plugin/src/ios/withCIOIosSwift.ts

@@ -17,7 +17,11 @@ import {
 import { replaceCodeByRegex } from '../helpers/utils/codeInjection';
 import { FileManagement } from '../helpers/utils/fileManagement';
 import { patchNativeSDKInitializer } from '../helpers/utils/patchPluginNativeCode';
-import type { CustomerIOPluginOptionsIOS, NativeSDKConfig } from '../types/cio-types';
+import type {
+  CustomerIOPluginOptionsIOS,
+  CustomerIOPluginLocationOptions,
+  NativeSDKConfig,
+} from '../types/cio-types';
 import { logger } from '../utils/logger';
 import { getIosNativeFilesPath } from '../utils/plugin';
 import { copyFileToXcode, getOrCreateCustomerIOGroup } from '../utils/xcode';
@@ -34,6 +38,7 @@ const copyAndConfigureAppDelegateHandler = (
   config: ExportedConfigWithProps<XcodeProject>,
   sdkConfig?: NativeSDKConfig,
   props?: CustomerIOPluginOptionsIOS,
+  location?: CustomerIOPluginLocationOptions,
 ): ExportedConfigWithProps<XcodeProject> => {
   // Destination path in the iOS project
   const projectName = config.modRequest.projectName || '';
@@ -59,6 +64,7 @@ const copyAndConfigureAppDelegateHandler = (
       projectName,
       sdkConfig,
       props,
+      location,
     });
   } else if (sdkConfig) {
     // Copy only CustomerIOSDKInitializer.swift for auto-init without push notifications
@@ -68,6 +74,7 @@ const copyAndConfigureAppDelegateHandler = (
       iosProjectRoot,
       projectName,
       sdkConfig,
+      location,
     });
   }
 
@@ -81,6 +88,7 @@ const copyAndConfigurePushAppDelegateHandler = ({
   projectName,
   sdkConfig,
   props,
+  location,
 }: {
   xcodeProject: XcodeProject;
   group: XcodeProject['pbxCreateGroup'];
@@ -88,6 +96,7 @@ const copyAndConfigurePushAppDelegateHandler = ({
   projectName: string;
   sdkConfig: NativeSDKConfig | undefined;
   props: CustomerIOPluginOptionsIOS;
+  location?: CustomerIOPluginLocationOptions;
 }) => {
   const useFcm = isFcmPushProvider(props);
 
@@ -156,7 +165,7 @@ const copyAndConfigurePushAppDelegateHandler = ({
   // Add auto initialization if sdkConfig is provided
   if (sdkConfig) {
     // Also copy CustomerIOSDKInitializer.swift for auto-initialization
-    copyAndConfigureNativeSDKInitializer({ xcodeProject, group, iosProjectRoot, projectName, sdkConfig });
+    copyAndConfigureNativeSDKInitializer({ xcodeProject, group, iosProjectRoot, projectName, sdkConfig, location });
 
     // Inject auto initialization call before MessagingPush initialization
     handlerFileContent = handlerFileContent.replace(CIO_MESSAGING_PUSH_APP_DELEGATE_INIT_REGEX, CIO_NATIVE_SDK_INITIALIZE_SNIPPET + '$1');
@@ -171,13 +180,18 @@ const copyAndConfigureNativeSDKInitializer = ({
   iosProjectRoot,
   projectName,
   sdkConfig,
+  location,
 }: {
   xcodeProject: XcodeProject;
   group: XcodeProject['pbxCreateGroup'];
   iosProjectRoot: string;
   projectName: string;
   sdkConfig: NativeSDKConfig;
+  location?: CustomerIOPluginLocationOptions;
 }) => {
+  const locationOptions = location
+    ? { enabled: location.enabled === true, trackingMode: sdkConfig?.location?.trackingMode }
+    : undefined;
   const filename = 'CustomerIOSDKInitializer.swift';
   const sourcePath = path.join(getIosNativeFilesPath(), filename);
   // Add the CustomerIOSDKInitializer.swift file to the same Xcode group as CioSdkAppDelegateHandler
@@ -187,7 +201,8 @@ const copyAndConfigureNativeSDKInitializer = ({
     projectName,
     sourceFilePath: sourcePath,
     targetFileName: filename,
-    transform: (content) => patchNativeSDKInitializer(content, PLATFORM.IOS, sdkConfig),
+    transform: (content) =>
+      patchNativeSDKInitializer(content, PLATFORM.IOS, sdkConfig, locationOptions),
     customerIOGroup: group,
   });
 };
@@ -196,10 +211,11 @@ export const withCIOIosSwift = (
   configOuter: ExpoConfig,
   sdkConfig?: NativeSDKConfig,
   props?: CustomerIOPluginOptionsIOS,
+  location?: CustomerIOPluginLocationOptions,
 ) => {
   // First, copy required swift files to iOS folder and add it to Xcode project
   configOuter = withXcodeProject(configOuter, async (config) => {
-    return copyAndConfigureAppDelegateHandler(config, sdkConfig, props);
+    return copyAndConfigureAppDelegateHandler(config, sdkConfig, props, location);
   });
 
   // Modify the AppDelegate based on configuration

package/plugin/src/ios/withXcodeProject.ts

@@ -1,18 +1,35 @@
 import type { ConfigPlugin } from '@expo/config-plugins';
 import { withXcodeProject } from '@expo/config-plugins';
 
-import { injectCIOPodfileCode } from '../helpers/utils/injectCIOPodfileCode';
+import {
+  injectCIOPodfileCode,
+  type InjectCIOPodfileOptions,
+} from '../helpers/utils/injectCIOPodfileCode';
 import type { CustomerIOPluginOptionsIOS } from '../types/cio-types';
 import { isFcmPushProvider } from './utils';
 
-export const withCioXcodeProject: ConfigPlugin<CustomerIOPluginOptionsIOS> = (
+export type WithCioXcodeProjectOptions = {
+  /** Options for Podfile host app snippet (location subspec, etc.) */
+  podfileOptions?: InjectCIOPodfileOptions;
+};
+
+/** Props for the CIO Xcode project mod; push options are optional when only location is enabled. */
+export type WithCioXcodeProjectProps = Partial<CustomerIOPluginOptionsIOS> &
+  WithCioXcodeProjectOptions;
+
+export const withCioXcodeProject: ConfigPlugin<WithCioXcodeProjectProps> = (
   config,
   cioProps
 ) => {
   return withXcodeProject(config, async (props) => {
     const iosPath = props.modRequest.platformProjectRoot;
+    const podfileOptions = cioProps?.podfileOptions;
 
-    await injectCIOPodfileCode(iosPath, isFcmPushProvider(cioProps));
+    await injectCIOPodfileCode(
+      iosPath,
+      isFcmPushProvider(cioProps as CustomerIOPluginOptionsIOS | undefined),
+      podfileOptions
+    );
 
     return props;
   });