feat: expo config plugin

.changeset/config.json

@@ -14,6 +14,7 @@
     "@callstack/brownfield-example-android-app",
     "@callstack/brownfield-example-ios-app",
     "@callstack/brownfield-example-rn-app",
+    "@callstack/brownfield-example-expo-app",
     "@callstack/react-native-brownfield-tester-integrated",
     "@callstack/brownfield-gradle-plugin-react"
   ],

.changeset/deep-garlics-sit.md

@@ -0,0 +1,5 @@
+---
+'@callstack/brownfield-cli': major
+---
+
+feat: support for CNG with new Expo config plugin

.changeset/tasty-apes-retire.md

@@ -0,0 +1,5 @@
+---
+'@callstack/react-native-brownfield': major
+---
+
+feat: add Expo config plugin

.github/actions/androidapp-road-test/action.yml

@@ -0,0 +1,63 @@
+name: Android road test (selected RN app & AndroidApp)
+description: Package the given RN app as AAR, publish to Maven Local, and build the corresponding AndroidApp flavor
+
+inputs:
+  flavor:
+    description: 'AndroidApp flavor to build (expo or vanilla)'
+    required: true
+
+  rn-project-path:
+    description: 'Path to the RN project to build'
+    required: true
+
+  rn-project-maven-path:
+    description: 'Maven path to the RN project, e.g. com/rnapp/brownfieldlib'
+    required: true
+
+runs:
+  using: composite
+  steps:
+    - name: Setup
+      uses: ./.github/actions/setup
+
+    - name: Prepare Android environment
+      uses: ./.github/actions/prepare-android
+
+    - name: Restore Gradle cache
+      uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5
+      with:
+        path: |
+          ~/.gradle/caches
+          ~/.gradle/wrapper
+        key: ${{ runner.os }}-android-androidapp-${{ inputs.flavor }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+        restore-keys: |
+          ${{ runner.os }}-android-androidapp-${{ inputs.flavor }}-gradle-
+          ${{ runner.os }}-android-androidapp-gradle-
+
+    # == RN app ==
+
+    - name: Package AAR with the Brownfield CLI
+      run: |
+        cd ${{ inputs.rn-project-path }}
+        yarn run brownfield:package:android
+      shell: bash
+
+    - name: Publish AAR artifact to Maven Local
+      run: |
+        cd ${{ inputs.rn-project-path }}
+        yarn run brownfield:publish:android
+      shell: bash
+
+    - name: Verify debug AAR exists in Maven Local
+      run: stat ~/.m2/repository/${{ inputs.rn-project-maven-path }}/0.0.1-SNAPSHOT/brownfieldlib-0.0.1-SNAPSHOT-debug.aar
+      shell: bash
+
+    - name: Verify release AAR exists in Maven Local
+      run: stat ~/.m2/repository/${{ inputs.rn-project-maven-path }}/0.0.1-SNAPSHOT/brownfieldlib-0.0.1-SNAPSHOT-release.aar
+      shell: bash
+
+    # == AndroidApp ==
+
+    - name: Build native Android Brownfield app
+      run: yarn run build:example:android-consumer:${{ inputs.flavor }}
+      shell: bash

.github/actions/appleapp-road-test/action.yml

@@ -0,0 +1,85 @@
+name: Apple road test (selected RN app & AppleApp)
+description: Package the given RN app as XCFramework, and build the corresponding AppleApp variant
+
+inputs:
+  variant:
+    description: 'AppleApp yarn command variant to run (expo or vanilla)'
+    required: true
+
+  rn-project-path:
+    description: 'Path to the RN project to build'
+    required: true
+
+runs:
+  using: composite
+  env:
+    USE_CCACHE: 1
+    CCACHE_DIR: ${{ github.workspace }}/.ios_ccache
+    CCACHE_BASEDIR: ${{ github.workspace }}
+    CCACHE_COMPRESS: '1'
+  steps:
+    - name: Checkout
+      uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+
+    - name: Setup
+      uses: ./.github/actions/setup
+
+    - name: Prepare iOS environment
+      uses: ./.github/actions/prepare-ios
+
+    - name: Install ccache
+      run: brew install ccache
+
+    - name: Enable ccache
+      run: echo "$(brew --prefix)/opt/ccache/libexec" >> $GITHUB_PATH
+
+    - name: Restore RNApp & AppleApp ccache
+      uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5
+      with:
+        path: |
+          .ios_ccache
+        key: ${{ runner.os }}-rnapp-appleapp-${{ inputs.variant }}-ios-ccache-${{ hashFiles(format('{0}/ios/Podfile.lock', inputs.rn-project-path), format('{0}/ios/*.xcodeproj/project.pbxproj', inputs.rn-project-path), 'apps/AppleApp/Brownfield Apple App.xcodeproj/project.pbxproj') }}
+        restore-keys: |
+          ${{ runner.os }}-rnapp-appleapp-${{ inputs.variant }}-ios-ccache-
+
+    # == RN app ==
+
+    - name: Restore Pods cache (RN ${{ inputs.variant }} app)
+      uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5
+      with:
+        path: |
+          ${{ inputs.rn-project-path }}/ios/Pods
+        key: ${{ runner.os }}-rnapp-${{ inputs.variant }}-ios-pods-${{ hashFiles(format('{0}/ios/Podfile.lock', inputs.rn-project-path)) }}
+        restore-keys: |
+          ${{ runner.os }}-rnapp-${{ inputs.variant }}-ios-pods-
+
+    - name: Install pods (RN ${{ inputs.variant }} app)
+      run: |
+        cd ${{ inputs.rn-project-path }}/ios
+        pod install
+
+    - name: Restore DerivedData cache (RN ${{ inputs.variant }} app)
+      uses: actions/cache@v5
+      with:
+        path: ${{ inputs.rn-project-path }}/ios/build
+        key: ${{ runner.os }}-ios-rnapp-${{ inputs.variant }}-derived-data-${{ hashFiles(format('{0}/ios/Podfile.lock', inputs.rn-project-path), format('{0}/ios/*.xcodeproj/project.pbxproj', inputs.rn-project-path)) }}
+        restore-keys: |
+          ${{ runner.os }}-ios-rnapp-${{ inputs.variant }}-derived-data-
+
+    - name: Package iOS framework with the Brownfield CLI
+      run: |
+        cd ${{ inputs.rn-project-path }}
+        yarn run brownfield:package:ios
+
+    # == AppleApp ==
+
+    - name: Build Brownfield iOS native app (${{ inputs.variant }})
+      run: |
+        yarn run build:example:ios-consumer:${{ inputs.variant }}
+
+    # ==============
+
+    - name: Log ccache stats
+      uses: ./.github/actions/ccache-summary
+      with:
+        name: RN ${{ inputs.variant }} app & AppleApp

.github/workflows/ci.yml

@@ -83,61 +83,44 @@ jobs:
       - name: Build integrated Android tester app
         run: yarn run build:tester-integrated:android
 
-  android-rnapp-androidapp:
-    name: Android road test (RNApp & AndroidApp)
+  android-androidapp-expo:
+    name: Android road test (RNApp & AndroidApp - Expo)
     runs-on: ubuntu-latest
     needs: build-lint
 
     steps:
       - name: Checkout
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Prepare Android environment
-        uses: ./.github/actions/prepare-android
-
-      - name: Restore Gradle cache
-        uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5
+      - name: Run RNApp -> AndroidApp road test (Expo)
+        uses: ./.github/actions/androidapp-road-test
         with:
-          path: |
-            ~/.gradle/caches
-            ~/.gradle/wrapper
-          key: ${{ runner.os }}-android-rnapp-androidapp-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
-          restore-keys: |
-            ${{ runner.os }}-android-rnapp-androidapp-gradle-
-
-      # == RNApp ==
-
-      - name: Package AAR with the Brownfield CLI
-        run: |
-          cd apps/RNApp
-          yarn run brownfield:package:android
-
-      - name: Publish AAR artifact to Maven Local
-        run: |
-          cd apps/RNApp
-          yarn run brownfield:publish:android
-
-      - name: Verify debug AAR exists in Maven Local
-        run: stat ~/.m2/repository/com/rnapp/brownfieldlib/0.0.1-local/brownfieldlib-0.0.1-local-debug.aar
+          flavor: expo
+          rn-project-path: apps/ExpoApp
+          rn-project-maven-path: com/expoapp/brownfieldlib
 
-      - name: Verify release AAR exists in Maven Local
-        run: stat ~/.m2/repository/com/rnapp/brownfieldlib/0.0.1-local/brownfieldlib-0.0.1-local-release.aar
+  android-androidapp-vanilla:
+    name: Android road test (RNApp & AndroidApp - Vanilla)
+    runs-on: ubuntu-latest
+    needs: build-lint
 
-      # == AndroidApp ==
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
-      - name: Build native Android Brownfield app
-        run: |
-          yarn run build:example:android-consumer
+      - name: Run RNApp -> AndroidApp road test (Vanilla)
+        uses: ./.github/actions/androidapp-road-test
+        with:
+          flavor: vanilla
+          rn-project-path: apps/RNApp
+          rn-project-maven-path: com/rnapp/brownfieldlib
 
   ios-tester-integrated:
     name: iOS road test (TesterIntegrated)
     runs-on: macos-26
     needs: build-lint
 
-    env: &ios_env
+    env:
       USE_CCACHE: 1
       CCACHE_DIR: ${{ github.workspace }}/.ios_ccache
       CCACHE_BASEDIR: ${{ github.workspace }}
@@ -203,76 +186,32 @@ jobs:
         with:
           name: TesterIntegrated
 
-  ios-rnapp-appleapp:
-    name: iOS road test (RNApp & AppleApp)
-    runs-on: macos-26
+  ios-appleapp-vanilla:
+    name: iOS road test (RNApp & AppleApp - Vanilla)
+    runs-on: ubuntu-latest
     needs: build-lint
 
-    env: *ios_env
-
     steps:
       - name: Checkout
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
-      - name: Setup
-        uses: ./.github/actions/setup
-
-      - name: Prepare iOS environment
-        uses: ./.github/actions/prepare-ios
-
-      - name: Install ccache
-        run: brew install ccache
-
-      - name: Enable ccache
-        run: echo "$(brew --prefix)/opt/ccache/libexec" >> $GITHUB_PATH
-
-      - name: Restore RNApp & AppleApp ccache
-        uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5
-        with:
-          path: |
-            .ios_ccache
-          key: ${{ runner.os }}-rnapp-appleapp-ios-ccache-${{ hashFiles('apps/RNApp/ios/Podfile.lock', 'apps/RNApp/ios/RNApp.xcodeproj/project.pbxproj', 'apps/AppleApp/Brownfield Apple App.xcodeproj/project.pbxproj') }}
-          restore-keys: |
-            ${{ runner.os }}-rnapp-appleapp-ios-ccache-
-
-      # == RNApp ==
-
-      - name: Restore Pods cache (RNApp)
-        uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5
-        with:
-          path: |
-            apps/RNApp/ios/Pods
-          key: ${{ runner.os }}-rnapp-ios-pods-${{ hashFiles('apps/RNApp/ios/Podfile.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-rnapp-ios-pods-
-
-      - name: Install pods (RNApp)
-        run: |
-          cd apps/RNApp/ios
-          pod install
-
-      - name: Restore DerivedData cache (RNApp)
-        uses: actions/cache@v5
+      - name: Run RNApp -> AppleApp road test (Vanilla)
+        uses: ./.github/actions/appleapp-road-test
         with:
-          path: apps/RNApp/ios/build
-          key: ${{ runner.os }}-ios-rnapp-derived-data-${{ hashFiles('apps/RNApp/ios/Podfile.lock', 'apps/RNApp/ios/RNApp.xcodeproj/project.pbxproj') }}
-          restore-keys: |
-            ${{ runner.os }}-ios-rnapp-derived-data-
+          variant: vanilla
+          rn-project-path: apps/RNApp
 
-      - name: Package iOS framework with the Brownfield CLI
-        run: |
-          cd apps/RNApp
-          yarn run brownfield:package:ios
-
-      # == AppleApp ==
-
-      - name: Build Brownfield iOS native app
-        run: |
-          yarn run build:example:ios-consumer
+  ios-appleapp-expo:
+    name: iOS road test (RNApp & AppleApp - Expo)
+    runs-on: ubuntu-latest
+    needs: build-lint
 
-      # ==============
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
-      - name: Log ccache stats
-        uses: ./.github/actions/ccache-summary
+      - name: Run RNApp -> AppleApp road test (Expo)
+        uses: ./.github/actions/appleapp-road-test
         with:
-          name: RNApp & AppleApp
+          variant: expo
+          rn-project-path: apps/RNApp

CONTRIBUTING.md

@@ -5,6 +5,7 @@
 Run `yarn` in the root of the repository to install all dependencies.
 
 Depending on your needs, you may need to install CocoaPods in a subset of the below directories:
+
 - example React Native iOS app: `cd apps/RNApp/ios && pod install`
 - integrated iOS tester app: `cd apps/TesterIntegrated/swift && pod install`
 
@@ -18,17 +19,18 @@ We use [changesets](https://github.com/changesets/changesets) to make it easier
 
 ## Scripts
 
-- `lint` - runs linting on all JS/TS source files in the monorepo *[Turbo]*
+- `lint` - runs linting on all JS/TS source files in the monorepo _[Turbo]_
 - `gradle-plugin:lint` - runs linting on the Brownfield Gradle plugin source code
-- `typecheck` - runs TypeScript type checking on all TS source files in the monorepo *[Turbo]*
-- `build` - runs all `build*` tasks in the Turbo repo - see below for more details *[Turbo]*
+- `typecheck` - runs TypeScript type checking on all TS source files in the monorepo _[Turbo]_
+- `build` - runs all `build*` tasks in the Turbo repo - see below for more details _[Turbo]_
 - `dev` - runs all `dev` tasks in all workspaces
 - `brownfield:plugin:publish:local` - publishes the Brownfield Gradle plugin to your local Maven repository for testing purposes
-- `build:brownfield` - builds the React Native Brownfield package (`packages/react-native-brownfield`) *[Turbo]*
-- `build:docs` - builds the documentation site (`docs/`) *[Turbo]*
+- `build:brownfield` - builds the React Native Brownfield package (`packages/react-native-brownfield`) _[Turbo]_
+- `build:docs` - builds the documentation site (`docs/`) _[Turbo]_
 - `build:tester-integrated:android` - builds the Android integrated tester app (`apps/TesterIntegrated/android`)
 - `build:tester-integrated:ios` - builds the iOS integrated tester app (`apps/TesterIntegrated/swift`)
 - `build:example:android-rn` - builds the example React Native app for Android (`apps/RNApp/android`)
 - `build:example:ios-rn` - builds the example React Native app for iOS (`apps/RNApp/ios`)
-- `build:example:android-consumer` - builds the example native Android consumer app (`apps/AndroidApp`)
-- `build:example:ios-consumer` - builds the example native Apple consumer app (`apps/AppleApp`)
+- `build:example:android-consumer:expo` - builds the example native Android consumer (`apps/AndroidApp`) app's flavor consuming the Expo RN app (`apps/ExpoApp`) artifact
+- - `build:example:android-consumer:vanilla` - builds the example native Android consumer (`apps/AndroidApp`) app's flavor consuming the vanilla RN app (`apps/RNApp`) artifact
+- `build:example:ios-consumer` - builds the example native Apple consumer app (`apps/AppleApp`)