Wire RN E2E dev commands

Author: kyle-schellen

dev.yml

@@ -425,6 +425,18 @@ commands:
               USE_LOCAL_SDK=1 ./scripts/publish_android_snapshot
               cd sample/android
               USE_LOCAL_SDK=1 ./gradlew :shopify_checkout-kit-react-native:test --refresh-dependencies
+      e2e:
+        desc: Run React Native sample Maestro guest checkout smoke flows
+        run: |
+          echo "Usage: dev rn e2e {ios|android}" >&2
+          exit 1
+        subcommands:
+          ios:
+            desc: Run the React Native iOS Maestro guest checkout smoke flow
+            run: cd platforms/react-native && ./scripts/e2e_maestro_ios
+          android:
+            desc: Run the React Native Android Maestro guest checkout smoke flow
+            run: cd platforms/react-native && ./scripts/e2e_maestro_android
       lint:
         desc: Run all React Native lint checks (Swift, module, sample)
         aliases: [style]

e2e/README.md

@@ -1,12 +1,47 @@
 # Checkout Kit End-to-End Tests
 
-This directory is reserved for cross-platform end-to-end tests. There is no runnable e2e suite checked in yet.
+This directory contains Maestro end-to-end smoke flows for Checkout Kit sample
+apps.
 
-Planned coverage:
+The current runnable suite starts with React Native. It verifies a full guest
+checkout from a seeded cart in the sample app, through Shopify checkout, and
+back to the app after completion.
 
-- Swift checkout presentation and protocol lifecycle.
-- Android checkout presentation and protocol lifecycle.
-- React Native wrapper behavior.
-- Web component open/close and `checkout:*` events.
+## Run locally
 
-Until this directory contains test code, use the platform test suites and sample apps described in each platform README.
+Run the matching command from the repo root.
+
+Run `dev up` first to provision the local toolchain. Install Maestro separately
+and make sure `maestro --version` succeeds before running these flows.
+
+React Native iOS:
+
+```bash
+dev rn e2e ios
+```
+
+React Native Android:
+
+```bash
+dev rn e2e android
+```
+
+The React Native commands start Metro if needed, build and launch the target
+sample app, then run Maestro. They require the standard storefront `.env` setup,
+but the E2E flow seeds its own cart through the bootstrap deep link; no manual
+sample cart setup is required.
+
+## Files
+
+- `config.yaml` configures Maestro for shared platform behavior.
+- `flows/` contains reusable Maestro subflows for app setup and checkout steps.
+- `tests/react-native/full-guest-checkout.yaml` composes the React Native guest
+  checkout smoke test from those subflows.
+
+## Scope
+
+This smoke flow is intended to catch regressions in the React Native sample app
+integration surface: cart bootstrap, checkout presentation, checkout
+completion, and return to the sample app. It is not a replacement for
+checkout-web's browser-based coverage or for future native Swift and Android
+sample-app E2E coverage.

platforms/react-native/CONTRIBUTING.md

@@ -84,7 +84,7 @@ CI uses the default (published) path naturally — no special flag handling. Kee
 
 ### Gotchas
 
-- **iOS**: `dev rn ios` runs `pod install` before launching, so dropping or adding `--local` will re-resolve the pods as needed. You can still run `dev rn pod-install [--local]` directly when you only want to refresh pods.
+- **iOS**: non-local runs use `pod install`, while `dev rn ios --local` and `dev rn pod-install --local` run a targeted update for the `ShopifyCheckoutKit` pods so CocoaPods re-resolves the local SDK path.
 - **Android (CLI)**: covered automatically by the publish script — every `--local` run re-publishes the local Android and Kotlin protocol artifacts before building.
 - **Android (Android Studio)**: when running the sample via Android Studio's Run button after editing `platforms/android/**` or `protocol/languages/kotlin/**`, run `platforms/react-native/scripts/publish_android_snapshot` once manually (with `USE_LOCAL_SDK=1`) or run `dev rn android --local` from a terminal to refresh `~/.m2/`.
 - The flag affects **only the RN build**. The standalone Swift and Android SDK builds (`dev android build`, `swift build`, etc.) are unaffected.

platforms/react-native/scripts/e2e_maestro_android

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+METRO_LOG="${TMPDIR:-/tmp}/checkout-kit-rn-android-metro.log"
+METRO_PID=""
+APP_ID="com.shopify.checkoutkit.reactnativedemo"
+CART_BOOTSTRAP_LINK="${APP_ID}://cart?productIndex=0&quantity=1"
+
+metro_running() {
+  curl --silent --fail http://localhost:8081/status | grep -q "packager-status:running"
+}
+
+cleanup() {
+  if [ -n "$METRO_PID" ]; then
+    kill "$METRO_PID" 2>/dev/null || true
+  fi
+}
+
+wait_for_metro() {
+  for _ in $(seq 1 60); do
+    if metro_running; then
+      return 0
+    fi
+    sleep 1
+  done
+
+  echo "Timed out waiting for Metro. Last log lines:" >&2
+  tail -n 40 "$METRO_LOG" >&2 || true
+  return 1
+}
+
+require_maestro() {
+  if ! maestro --version >/dev/null 2>&1; then
+    echo "Maestro is required to run React Native E2E tests." >&2
+    echo "Install Maestro and make sure maestro --version succeeds." >&2
+    return 1
+  fi
+}
+
+cd "$ROOT_DIR"
+
+require_maestro
+
+if ! metro_running; then
+  /opt/dev/bin/dev react-native start >"$METRO_LOG" 2>&1 &
+  METRO_PID="$!"
+  trap cleanup EXIT
+fi
+
+wait_for_metro
+pnpm sample android --local --extra-params "--refresh-dependencies"
+maestro --platform android test --config ../../e2e/config.yaml \
+  -e "APP_ID=${APP_ID}" \
+  -e "CART_BOOTSTRAP_LINK=${CART_BOOTSTRAP_LINK}" \
+  ../../e2e/tests/react-native/full-guest-checkout.yaml

platforms/react-native/scripts/e2e_maestro_ios

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+METRO_LOG="${TMPDIR:-/tmp}/checkout-kit-rn-ios-metro.log"
+METRO_PID=""
+APP_ID="com.shopify.checkoutkit.reactnativedemo"
+CART_BOOTSTRAP_LINK="${APP_ID}://cart?productIndex=0&quantity=1"
+
+metro_running() {
+  curl --silent --fail http://localhost:8081/status | grep -q "packager-status:running"
+}
+
+cleanup() {
+  if [ -n "$METRO_PID" ]; then
+    kill "$METRO_PID" 2>/dev/null || true
+  fi
+}
+
+wait_for_metro() {
+  for _ in $(seq 1 60); do
+    if metro_running; then
+      return 0
+    fi
+    sleep 1
+  done
+
+  echo "Timed out waiting for Metro. Last log lines:" >&2
+  tail -n 40 "$METRO_LOG" >&2 || true
+  return 1
+}
+
+require_maestro() {
+  if ! maestro --version >/dev/null 2>&1; then
+    echo "Maestro is required to run React Native E2E tests." >&2
+    echo "Install Maestro and make sure maestro --version succeeds." >&2
+    return 1
+  fi
+}
+
+cd "$ROOT_DIR"
+
+require_maestro
+
+if ! metro_running; then
+  /opt/dev/bin/dev react-native start >"$METRO_LOG" 2>&1 &
+  METRO_PID="$!"
+  trap cleanup EXIT
+fi
+
+wait_for_metro
+pnpm sample ios --local
+maestro --platform ios test --config ../../e2e/config.yaml \
+  -e "APP_ID=${APP_ID}" \
+  -e "CART_BOOTSTRAP_LINK=${CART_BOOTSTRAP_LINK}" \
+  ../../e2e/tests/react-native/full-guest-checkout.yaml

platforms/react-native/scripts/pod_install

@@ -10,4 +10,9 @@ done
 
 cd sample/ios
 bundle check || bundle install
-bundle exec pod install --repo-update
+
+if [ "${USE_LOCAL_SDK:-0}" = "1" ]; then
+  bundle exec pod update ShopifyCheckoutKit ShopifyCheckoutKit/AcceleratedCheckouts --repo-update
+else
+  bundle exec pod install --repo-update
+fi