Migrate React Native sample to Expo prebuild

.github/workflows/rn-build-ios.yml

@@ -49,23 +49,6 @@ jobs:
           bundler-cache: true
           working-directory: platforms/react-native/sample
 
-      - name: Verify iOS lockfile uses published native SDK
-        run: scripts/check_published_podfile_lock sample/ios/Podfile.lock
-
-      - name: Cache cocoapods
-        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
-        with:
-          path: platforms/react-native/sample/ios/Pods
-          key: ${{ runner.os }}-cocoapods-${{ hashFiles('platforms/react-native/sample/ios/Podfile.lock', 'platforms/react-native/sample/Gemfile.lock', 'platforms/react-native/sample/Gemfile', 'platforms/react-native/package.json', 'platforms/react-native/sample/package.json', 'platforms/react-native/modules/@shopify/checkout-kit-react-native/package.json', 'platforms/react-native/pnpm-lock.yaml') }}
-
-      - name: Install cocoapods
-        working-directory: platforms/react-native/sample
-        run: |
-          set -euo pipefail
-          bundle install
-          cd ios
-          bundle exec pod install --deployment --repo-update
-
       - name: Build module
         run: pnpm module build
 

.github/workflows/rn-test-ios.yml

@@ -26,14 +26,6 @@ jobs:
           echo "Xcode Path: $(xcode-select -p)"
           echo "Xcode Version: $(xcrun xcodebuild -version)"
 
-      - name: Setup iOS Simulator
-        run: |
-          xcrun simctl list runtimes
-          xcrun simctl list devicetypes | grep iPhone
-          xcrun simctl delete all
-          CURRENT_SIMULATOR_UUID=$(xcrun simctl create TestDevice "iPhone 16 Pro")
-          echo "CURRENT_SIMULATOR_UUID=$CURRENT_SIMULATOR_UUID" >> "$GITHUB_ENV"
-
       - name: Setup Node.js, pnpm, and install dependencies
         uses: ./.github/actions/setup
         with:
@@ -42,30 +34,6 @@ jobs:
           package-json-file: platforms/react-native/package.json
           working-directory: platforms/react-native
 
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@89f90524b88a01fe6e0b732220432cc6142926af # v1.313.0
-        with:
-          ruby-version: 3.3.6
-          bundler-cache: true
-          working-directory: platforms/react-native/sample
-
-      - name: Verify iOS lockfile uses published native SDK
-        run: scripts/check_published_podfile_lock sample/ios/Podfile.lock
-
-      - name: Cache cocoapods
-        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
-        with:
-          path: platforms/react-native/sample/ios/Pods
-          key: ${{ runner.os }}-cocoapods-${{ hashFiles('platforms/react-native/sample/ios/Podfile.lock', 'platforms/react-native/sample/Gemfile.lock', 'platforms/react-native/sample/Gemfile', 'platforms/react-native/package.json', 'platforms/react-native/sample/package.json', 'platforms/react-native/modules/@shopify/checkout-kit-react-native/package.json', 'platforms/react-native/pnpm-lock.yaml') }}
-
-      - name: Install cocoapods
-        working-directory: platforms/react-native/sample
-        run: |
-          set -euo pipefail
-          bundle install
-          cd ios
-          bundle exec pod install --deployment --repo-update
-
       - name: Build module
         run: pnpm module build
 

.gitignore

@@ -29,10 +29,11 @@ platforms/react-native/test/rct-integration-app/*.xcworkspace/
 **/*.entitlements
 platforms/swift/Samples/**/Info.plist
 platforms/react-native/test/rct-integration-app/**/Info.plist
-# Exception: the React Native sample's entitlements are source code (associated
-# domains + in-app payments merchant ID), not secrets — Xcode requires this file
-# at build time and CI fails without it.
-!platforms/react-native/sample/ios/ReactNative/ReactNative.entitlements
+
+# Generated React Native sample native projects
+platforms/react-native/sample/.expo/
+platforms/react-native/sample/ios/
+platforms/react-native/sample/android/
 
 # Apollo / GraphQL
 *.graphqls

dev.yml

@@ -27,6 +27,10 @@ up:
       name: Run Checkout Kit workspace setup
       met?: ./scripts/setup_dev_workspace --check --skip-optional-prompts
       meet: ./scripts/setup_dev_workspace --skip-optional-prompts
+  - custom:
+      name: Prebuild React Native sample native projects
+      met?: "false"
+      meet: cd platforms/react-native && pnpm run prebuild -- all
 
 open:
   "GitHub": "https://github.com/Shopify/checkout-kit"
@@ -361,13 +365,12 @@ commands:
           Runs unit tests across all three React Native targets:
             - JS:      Jest tests in `platforms/react-native/modules/@shopify/checkout-kit-react-native/tests/`
             - iOS:     Xcode/CocoaPods tests in `platforms/react-native/test/rct-integration-app/`
-            - Android: Gradle JVM tests for `:shopify_checkout-kit-react-native` (requires a local Maven publish of `:lib`)
+            - Android: Gradle JVM tests for `:shopify_checkout-kit-react-native`
         run: |
           set -e
           cd platforms/react-native && pnpm test
           pnpm sample test:ios
-          USE_LOCAL_SDK=1 ./scripts/publish_android_snapshot
-          cd sample/android && USE_LOCAL_SDK=1 ./gradlew :shopify_checkout-kit-react-native:test --refresh-dependencies
+          pnpm sample test:android -- --refresh-dependencies
         subcommands:
           js:
             desc: Run JS unit tests via jest
@@ -376,13 +379,11 @@ commands:
             desc: Run native iOS unit tests via the RCT integration app
             run: cd platforms/react-native && pnpm sample test:ios
           android:
-            desc: Run native Android unit tests for the RN module (publishes/uses local platforms/android SDK)
+            desc: Run native Android unit tests for the RN module
             run: |
               set -e
               cd platforms/react-native
-              USE_LOCAL_SDK=1 ./scripts/publish_android_snapshot
-              cd sample/android
-              USE_LOCAL_SDK=1 ./gradlew :shopify_checkout-kit-react-native:test --refresh-dependencies
+              pnpm sample test:android -- --refresh-dependencies
       lint:
         desc: Run all React Native lint checks (Swift, module, sample)
         aliases: [style]
@@ -444,10 +445,10 @@ commands:
           fi
           echo "Cleaned root, module and sample workspaces"
 
-      server:
+      start:
         desc: Start Metro development server
-        aliases: [s]
-        run: cd platforms/react-native && pnpm sample start --reset-cache
+        aliases: [s, server]
+        run: cd platforms/react-native && pnpm sample start "$@"
 
       ios:
         desc: Run the iOS sample app in the simulator.
@@ -471,16 +472,24 @@ commands:
           optional: --local
         run: cd platforms/react-native && pnpm sample android "$@"
 
-      pod-install:
-        desc: Install CocoaPods for the iOS sample.
+      prebuild:
+        desc: Prebuild generated native sample projects.
         long_desc: |
-          Runs pod install for the iOS sample app.
+          Runs Expo prebuild for the React Native sample and prepares platform-specific native dependencies.
+          Native folders are regenerated from a clean Expo prebuild on every run.
+
+            dev rn prebuild                         Prebuild iOS and Android
+            dev rn prebuild ios                     Prebuild iOS and install CocoaPods
+            dev rn prebuild android                 Prebuild Android
+            dev rn prebuild all                     Regenerate iOS and Android native projects
+            dev rn prebuild ios --local             Prebuild iOS against in-repo Swift SDK sources
+            dev rn prebuild android --local         Prebuild Android against in-repo Android SDK artifacts
 
           --local
-            Wire the Podfile against in-repo Swift SDK sources.
+            Use in-repo native SDKs where supported.
         syntax:
-          optional: --local
-        run: cd platforms/react-native && pnpm run pod-install -- "$@"
+          optional: "[ios|android|all] [--local] [-- <expo prebuild args>]"
+        run: cd platforms/react-native && pnpm run prebuild -- "$@"
 
       open:
         desc: Open the React Native workspace root or native sample projects

platforms/react-native/.gitignore

@@ -103,8 +103,10 @@ modules/@shopify/checkout-kit-react-native/android/gradlew.bat
 # Local gems
 sample/vendor
 
-# Sample app
-sample/**/AndroidManifest.xml
+# Generated sample app native projects
+sample/.expo/
+sample/ios/
+sample/android/
 
 .claude/
 CLAUDE.md

platforms/react-native/README.md

@@ -223,7 +223,10 @@ Here's an example of how to get started with Apollo:
 
 ```tsx
 import {ApolloClient, gql, ApolloProvider} from '@apollo/client';
-import {API_VERSION, STOREFRONT_DOMAIN, STOREFRONT_ACCESS_TOKEN} from '@env';
+
+const API_VERSION = '2026-04';
+const STOREFRONT_DOMAIN = 'your-store.myshopify.com';
+const STOREFRONT_ACCESS_TOKEN = 'your-public-storefront-access-token';
 
 // Create a new instance of the ApolloClient
 const client = new ApolloClient({

platforms/react-native/__mocks__/expo-constants.ts

@@ -0,0 +1,18 @@
+const Constants = {
+  expoConfig: {
+    extra: {
+      API_VERSION: '2026-04',
+      CUSTOMER_ACCOUNT_API_SHOP_ID: 'test-shop-123',
+      CUSTOMER_ACCOUNT_API_CLIENT_ID: 'test-client-456',
+      STOREFRONT_DOMAIN: 'test-shop.myshopify.com',
+      STOREFRONT_ACCESS_TOKEN: 'test-storefront-token',
+    },
+  },
+};
+
+module.exports = {
+  __esModule: true,
+  default: Constants,
+};
+
+export {};

platforms/react-native/__mocks__/expo-crypto.ts

@@ -0,0 +1,12 @@
+const getRandomBytes = jest.fn((size: number) => new Uint8Array(size).fill(1));
+const digestStringAsync = jest.fn(async () => btoa(String.fromCharCode(...new Uint8Array(32).fill(1))));
+
+module.exports = {
+  __esModule: true,
+  CryptoDigestAlgorithm: {SHA256: 'SHA-256'},
+  CryptoEncoding: {BASE64: 'base64'},
+  getRandomBytes,
+  digestStringAsync,
+};
+
+export {};

platforms/react-native/__mocks__/react-native-encrypted-storage.ts → platforms/react-native/__mocks__/expo-secure-store.ts

@@ -1,13 +1,13 @@
 const store: Record<string, string> = {};
 
-const EncryptedStorage = {
-  setItem: jest.fn(async (key: string, value: string) => {
+const SecureStore = {
+  setItemAsync: jest.fn(async (key: string, value: string) => {
     store[key] = value;
   }),
-  getItem: jest.fn(async (key: string) => {
+  getItemAsync: jest.fn(async (key: string) => {
     return store[key] ?? null;
   }),
-  removeItem: jest.fn(async (key: string) => {
+  deleteItemAsync: jest.fn(async (key: string) => {
     delete store[key];
   }),
   clear: jest.fn(async () => {
@@ -17,5 +17,8 @@ const EncryptedStorage = {
 
 module.exports = {
   __esModule: true,
-  default: EncryptedStorage,
+  ...SecureStore,
+  default: SecureStore,
 };
+
+export {};

platforms/react-native/__mocks__/react-native.ts

@@ -92,6 +92,7 @@ const ShopifyCheckoutKit = {
   isApplePayAvailable: jest.fn(() => true),
   addListener: jest.fn(),
   removeListeners: jest.fn(),
+  eventEmitter: shopifyCheckoutKitEventEmitter,
 };
 
 // CommonJS export for Jest manual mock resolution
@@ -105,6 +106,12 @@ module.exports = {
   requireNativeComponent,
   codegenNativeComponent,
   TurboModuleRegistry: {
+    get: jest.fn((name: string) => {
+      if (name === 'ShopifyCheckoutKit') {
+        return ShopifyCheckoutKit;
+      }
+      return null;
+    }),
     getEnforcing: jest.fn((name: string) => {
       if (name === 'ShopifyCheckoutKit') {
         return ShopifyCheckoutKit;
@@ -113,10 +120,9 @@ module.exports = {
     }),
   },
   NativeModules: {
-    ShopifyCheckoutKit: {
-      ...ShopifyCheckoutKit,
-      eventEmitter: shopifyCheckoutKitEventEmitter,
-    },
+    ShopifyCheckoutKit,
   },
   StyleSheet,
 };
+
+export {};

platforms/react-native/babel.config.js

@@ -1,3 +1,3 @@
 module.exports = {
-  presets: ['module:@react-native/babel-preset'],
+  presets: ['babel-preset-expo'],
 };

platforms/react-native/jest.config.js

@@ -1,16 +1,13 @@
 module.exports = {
-  preset: 'react-native',
+  preset: 'jest-expo',
   modulePathIgnorePatterns: ['modules/@shopify/checkout-kit-react-native/lib'],
   modulePaths: ['<rootDir>/node_modules', '<rootDir>/sample/node_modules'],
+  moduleNameMapper: {
+    '^react$': '<rootDir>/node_modules/react',
+    '^react-native$': '<rootDir>/__mocks__/react-native.ts',
+  },
   setupFiles: ['<rootDir>/jest.setup.ts'],
   transform: {
     '\\.[jt]sx?$': 'babel-jest',
   },
-  globals: {
-    'ts-jest': {
-      tsConfig: {
-        importHelpers: true,
-      },
-    },
-  },
 };