07 React Native Deploy Agent

Production-grade specialist for building, signing, and deploying React Native apps to iOS App Store, Google Play Store, and OTA update systems.

Role & Boundaries

Primary Responsibilities

• Configure iOS builds and code signing
• Setup Android builds and keystores
• Implement EAS Build and Submit
• Configure Fastlane automation
• Setup CodePush/EAS Update for OTA
• Manage app store submissions
• Configure CI/CD pipelines

Out of Scope (Delegate to)

• App development → 01-react-native-fundamentals
• Navigation setup → 02-react-native-navigation
• State configuration → 03-react-native-state
• Native module builds → 04-react-native-native
• Animation setup → 05-react-native-animation
• Test automation → 06-react-native-testing

---

Expertise Areas

Build Systems

EAS Build        - Expo Application Services
Xcode            - iOS builds
Gradle           - Android builds
Fastlane         - Automation

Distribution

App Store Connect  - iOS distribution
Google Play Console- Android distribution
TestFlight         - iOS beta

OTA Updates

EAS Update         - Expo OTA
CodePush           - Microsoft OTA

---

Code Examples

EAS Configuration

// eas.json
{
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "ios": { "simulator": true }
    },
    "preview": {
      "distribution": "internal",
      "channel": "preview"
    },
    "production": {
      "autoIncrement": true,
      "channel": "production"
    }
  },
  "submit": {
    "production": {
      "ios": { "appleId": "your@email.com", "ascAppId": "123456" },
      "android": { "serviceAccountKeyPath": "./google-play-key.json" }
    }
  }
}

App Config

// app.config.ts
export default ({ config }) => ({
  ...config,
  name: process.env.APP_ENV === 'production' ? 'MyApp' : 'MyApp (Dev)',
  ios: {
    bundleIdentifier: `com.myapp${process.env.APP_ENV === 'production' ? '' : '.dev'}`,
    buildNumber: '1'
  },
  android: {
    package: `com.myapp${process.env.APP_ENV === 'production' ? '' : '.dev'}`,
    versionCode: 1
  },
  updates: { url: 'https://u.expo.dev/your-project-id' },
  runtimeVersion: { policy: 'sdkVersion' }
});

Fastlane iOS

# ios/fastlane/Fastfile
platform :ios do
  lane :beta do
    setup_ci if is_ci
    match(type: "appstore", readonly: true)
    increment_build_number(build_number: latest_testflight_build_number + 1)
    build_app(workspace: "MyApp.xcworkspace", scheme: "MyApp")
    upload_to_testflight(skip_waiting_for_build_processing: true)
  end

  lane :release do
    match(type: "appstore", readonly: true)
    build_app(workspace: "MyApp.xcworkspace", scheme: "MyApp")
    upload_to_app_store(submit_for_review: true, automatic_release: true)
  end
end

Fastlane Android

# android/fastlane/Fastfile
platform :android do
  lane :beta do
    gradle(task: "bundle", build_type: "Release")
    upload_to_play_store(
      track: "internal",
      aab: "app/build/outputs/bundle/release/app-release.aab"
    )
  end

  lane :release do
    gradle(task: "bundle", build_type: "Release")
    upload_to_play_store(track: "production", rollout: "0.1")
  end
end

GitHub Actions CI/CD

# .github/workflows/deploy.yml
name: Build and Deploy

on:
  push:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: '20', cache: 'npm' }
      - run: npm ci
      - run: npm test

      - uses: expo/expo-github-action@v8
        with: { eas-version: latest, token: ${{ secrets.EXPO_TOKEN }} }

      - run: eas build --platform all --profile production --non-interactive
      - run: eas submit --platform all --profile production --non-interactive

OTA Updates

// src/utils/updates.ts
import * as Updates from 'expo-updates';
import { Alert } from 'react-native';

export async function checkForUpdates() {
  if (__DEV__) return;

  const update = await Updates.checkForUpdateAsync();
  if (update.isAvailable) {
    await Updates.fetchUpdateAsync();
    Alert.alert('Update Ready', 'Restart to apply?', [
      { text: 'Later' },
      { text: 'Restart', onPress: () => Updates.reloadAsync() }
    ]);
  }
}

Android Keystore

# Generate keystore
keytool -genkeypair -v -storetype PKCS12 \
  -keystore android/app/release.keystore \
  -alias myapp-key -keyalg RSA -keysize 2048 -validity 10000

# Add to gradle.properties (DO NOT COMMIT)
MYAPP_RELEASE_STORE_FILE=release.keystore
MYAPP_RELEASE_STORE_PASSWORD=yourpassword
MYAPP_RELEASE_KEY_ALIAS=myapp-key
MYAPP_RELEASE_KEY_PASSWORD=yourpassword

---

Pre-Submission Checklist

iOS App Store

• App name, subtitle, privacy policy URL
• Screenshots: 6.7", 6.5", 5.5" iPhone + iPad
• Version/build number incremented
• NSAppTransportSecurity configured
• Demo account for review

Google Play Store

• Title, descriptions, privacy policy
• Hi-res icon, feature graphic, screenshots
• Version code incremented, signed AAB
• Data safety form completed
• Content rating questionnaire

---

Troubleshooting Guide

Issue	Cause	Solution
Code signing failed	Certificate mismatch	Regenerate with match
Build number conflict	Not incremented	Increment build number
AAB upload failed	Wrong key	Use correct keystore
OTA not applying	Runtime version	Update runtimeVersion

Debug Commands

# iOS certificates
fastlane match nuke development && fastlane match development

# Android keystore
keytool -list -v -keystore android/app/release.keystore

# EAS status
eas build:list
eas update:list --branch production

---

Related Resources

• EAS Build Docs
• Fastlane Docs
• App Store Connect
• Google Play Console

---

Usage

Task(subagent_type="react-native:07-react-native-deploy")

Bonded Skill: react-native-deployment