feat: brownfield unified CLI (#176)

* chore: squashed rework of repo

* ci: consolidate per-platform jobs to reduce cache entry count

* feat: brownfield CLI

* chore: add missing dependencies

* chore: add build:watch script

* feat: android CLI

* feat: iOS CLI

* ci: update CI to use the new iOS CLI

* chore: update Podfile for RNApp

* chore: move CLI files to new package

* chore: config files for new packages

* chore: react-native-brownfield package to depend on the CLI

* chore: update CONTRIBUTING.md

* fix: problems with imports and scripts

* docs: add CLI docs

* ci: adjust paths to CLI

* fix: iOS build error from brownie PR

* fix: linting

* feat: unified CLI

* ci: use brownie CLI in CI

* feat: adjust to new Rock API

* docs: add CLI documentation

* fix: make Rock iOS packaging logic work in non-Rock projects

* chore: depend on production rock packages

* fix: brownie CLI iOS - pass packageDir to Rock helpers and use .brownie folder as output base

* chore: bump up Rock to 0.12.5

* chore: rename build:watch scripts to dev

* WIP

* feat: migrate to vitest

* refactor: changes after CR

* fix: problems after migration to vitest

* refactor: rename brownie CLI to brownfield to resolve ambiguity

* refactor: changes after CR

* fix(docs): typo & dead link

* feat: new package name for brownfield CLI

* fix: retrieve proper RN version for iOS build

* docs: improve CLI docs

* chore: add verbose logging to RNApp package scripts

* chore: target iOS 15.6 in RNApp to match CI environment

* chore: depend on CLI package in brownie

* fix(ci): typo in step name

* fix(ci): workaround for ENOSPC and leftover character in iOS command

* docs: updated docs

* feat: rename CLI output directory to .brownfield

* fix(demo): use new path to iOS artifacts

---------

Co-authored-by: Oskar Kwaśniewski <oskarkwasniewski@icloud.com>

Author: artus9033

.eslintrc.json

@@ -1,6 +1,6 @@
 {
   "root": true,
-  "extends": ["@react-native", "prettier"],
+  "extends": ["prettier"],
   "plugins": ["prettier"],
   "ignorePatterns": ["node_modules/", "lib/"]
 }

.github/workflows/ci.yml

@@ -30,8 +30,12 @@ jobs:
       - name: Typecheck files
         run: yarn typecheck
 
-  tester-android:
-    name: Integrated tester Android App
+      - name: Test Brownfield CLI
+        run: |
+          yarn workspace @callstack/react-native-brownfield brownfield --version
+
+  android:
+    name: 'Android: integrated tester & integration workflow with CLI'
     runs-on: ubuntu-latest
     needs: build-lint
 
@@ -48,6 +52,18 @@ jobs:
           distribution: 'zulu'
           java-version: '17'
 
+      - name: Free Disk Space (Ubuntu)
+        uses: jlumbroso/free-disk-space@54081f138730dfa15788a46383842cd2f914a1be # v1.3.1
+        with:
+          tool-cache: false
+
+          android: false
+          dotnet: true
+          haskell: true
+          large-packages: true
+          docker-images: true
+          swap-storage: true
+
       - name: Setup Node.js
         uses: actions/setup-node@65d868f8d4d85d7d4abb7de0875cde3fcc8798f5 # v6
         with:
@@ -71,7 +87,7 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-tester-android-build-
 
-      - name: Resture Gradle cache
+      - name: Restore Gradle cache
         uses: actions/cache@9255dc7a253b0ccc959486e2bca901246202afeb # v5
         with:
           path: |
@@ -81,10 +97,39 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-tester-integrated-android-gradle-
 
+      # == IntegratedTester ==
+
+      - name: Generate Brownie stores
+        run: yarn run brownfield:codegen
+
       - name: Build integrated Android tester app
         run: yarn run build:tester-integrated:android
 
-  tester-ios:
+      # == 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
+
+      - 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
+
+      # == AndroidApp ==
+
+      - name: Build native Android Brownfield app
+        run: |
+          yarn run build:example:android-consumer
+
+  ios:
     name: Integrated tester iOS App
     runs-on: macos-latest
     needs: build-lint
@@ -130,6 +175,26 @@ jobs:
           cd apps/TesterIntegrated/swift
           pod install
 
+      # == IntegratedTester ==
+
       - name: Build integrated iOS tester app
         run: |
           yarn run build:tester-integrated:ios
+
+      # == RNApp ==
+
+      - name: Install pods (RNApp)
+        run: |
+          cd apps/RNApp/ios
+          pod install
+
+      - 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

.gitignore

@@ -79,3 +79,6 @@ lib/
 
 # Gradle
 secring.gpg
+
+# Typescript
+**/*.tsbuildinfo

.prettierignore

@@ -1,2 +1,3 @@
 node_modules
 lib
+dist

CONTRIBUTING.md

@@ -8,12 +8,21 @@ Depending on your needs, you may need to install CocoaPods in a subset of the be
 - example React Native iOS app: `cd apps/RNApp/ios && pod install`
 - integrated iOS tester app: `cd apps/TesterIntegrated/swift && pod install`
 
+## Contributing changes
+
+After contributing your changes, please make sure to add a [changeset](https://github.com/changesets/changesets) describing your changes. This will help us in publishing new versions.
+
+## Publishing to npm
+
+We use [changesets](https://github.com/changesets/changesets) to make it easier to publish new versions. It handles common tasks like bumping version based on semver, creating tags and releases etc.
+
 ## Scripts
 
 - `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]* 
+- `dev` - runs all `dev` tasks in all workspaces
 - `release` - releases a new version of React Native Brownfield package using `release-it`
 - `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]* 

apps/AppleApp/Brownfield Apple App.xcodeproj/project.pbxproj

@@ -33,9 +33,9 @@
 
 /* Begin PBXFileReference section */
 		793C76A72EEBF938008A2A34 /* Brownfield Apple App.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "Brownfield Apple App.app"; sourceTree = BUILT_PRODUCTS_DIR; };
-		79A9BC7E2EF5781F009EC2E3 /* BrownfieldLib.xcframework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.xcframework; name = BrownfieldLib.xcframework; path = ../RNApp/ios/out/Release/BrownfieldLib.xcframework; sourceTree = SOURCE_ROOT; };
-		79A9BC7F2EF5781F009EC2E3 /* hermesvm.xcframework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.xcframework; name = hermesvm.xcframework; path = ../RNApp/ios/out/Release/hermesvm.xcframework; sourceTree = SOURCE_ROOT; };
-		79A9BC802EF5781F009EC2E3 /* ReactBrownfield.xcframework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.xcframework; name = ReactBrownfield.xcframework; path = ../RNApp/ios/out/Release/ReactBrownfield.xcframework; sourceTree = SOURCE_ROOT; };
+		79A9BC7E2EF5781F009EC2E3 /* BrownfieldLib.xcframework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.xcframework; name = BrownfieldLib.xcframework; path = ../RNApp/ios/.brownfield/package/BrownfieldLib.xcframework; sourceTree = SOURCE_ROOT; };
+		79A9BC7F2EF5781F009EC2E3 /* hermesvm.xcframework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.xcframework; name = hermesvm.xcframework; path = ../RNApp/ios/.brownfield/package/hermesvm.xcframework; sourceTree = SOURCE_ROOT; };
+		79A9BC802EF5781F009EC2E3 /* ReactBrownfield.xcframework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.xcframework; name = ReactBrownfield.xcframework; path = ../RNApp/ios/.brownfield/package/ReactBrownfield.xcframework; sourceTree = SOURCE_ROOT; };
 /* End PBXFileReference section */
 
 /* Begin PBXFileSystemSynchronizedRootGroup section */

apps/RNApp/.eslintrc.json

@@ -0,0 +1,5 @@
+{
+  "extends": ["@react-native", "prettier"],
+  "plugins": ["prettier"],
+  "ignorePatterns": ["node_modules/", "lib/"]
+}

apps/RNApp/ios/.gitignore

@@ -1 +1 @@
-out
+.brownfield

apps/RNApp/ios/Podfile.lock

@@ -2438,7 +2438,7 @@ PODS:
     - React-perflogger (= 0.82.1)
     - React-utils (= 0.82.1)
     - SocketRocket
-  - RNScreens (4.18.0):
+  - RNScreens (4.19.0):
     - boost
     - DoubleConversion
     - fast_float
@@ -2465,10 +2465,10 @@ PODS:
     - ReactCodegen
     - ReactCommon/turbomodule/bridging
     - ReactCommon/turbomodule/core
-    - RNScreens/common (= 4.18.0)
+    - RNScreens/common (= 4.19.0)
     - SocketRocket
     - Yoga
-  - RNScreens/common (4.18.0):
+  - RNScreens/common (4.19.0):
     - boost
     - DoubleConversion
     - fast_float
@@ -2814,10 +2814,10 @@ SPEC CHECKSUMS:
   ReactBrownfield: 1609c411abb926b1fd3c8557ef67d4138fb56a02
   ReactCodegen: 0bce2d209e2e802589f4c5ff76d21618200e74cb
   ReactCommon: 801eff8cb9c940c04d3a89ce399c343ee3eff654
-  RNScreens: 98771ad898d1c0528fc8139606bbacf5a2e9d237
+  RNScreens: d6413aeb1878cdafd3c721e2c5218faf5d5d3b13
   SocketRocket: d4aabe649be1e368d1318fdf28a022d714d65748
   Yoga: 46ff53afcbeda2bae19c85b65e17487c3e3984dd
 
-PODFILE CHECKSUM: df18b5948daeaea0547157dc0e289b1adc4ed10c
+PODFILE CHECKSUM: 7c116a16dd0744063c8c6293dbfc638c9d447c19
 
 COCOAPODS: 1.15.2

apps/RNApp/ios/RNApp.xcodeproj/project.pbxproj

@@ -291,10 +291,14 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-RNApp/Pods-RNApp-frameworks-${CONFIGURATION}-input-files.xcfilelist",
 			);
+			inputPaths = (
+			);
 			name = "[CP] Embed Pods Frameworks";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-RNApp/Pods-RNApp-frameworks-${CONFIGURATION}-output-files.xcfilelist",
 			);
+			outputPaths = (
+			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-RNApp/Pods-RNApp-frameworks.sh\"\n";
@@ -330,10 +334,14 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-RNApp-BrownfieldLib/Pods-RNApp-BrownfieldLib-resources-${CONFIGURATION}-input-files.xcfilelist",
 			);
+			inputPaths = (
+			);
 			name = "[CP] Copy Pods Resources";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-RNApp-BrownfieldLib/Pods-RNApp-BrownfieldLib-resources-${CONFIGURATION}-output-files.xcfilelist",
 			);
+			outputPaths = (
+			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-RNApp-BrownfieldLib/Pods-RNApp-BrownfieldLib-resources.sh\"\n";
@@ -389,10 +397,14 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-RNApp/Pods-RNApp-resources-${CONFIGURATION}-input-files.xcfilelist",
 			);
+			inputPaths = (
+			);
 			name = "[CP] Copy Pods Resources";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-RNApp/Pods-RNApp-resources-${CONFIGURATION}-output-files.xcfilelist",
 			);
+			outputPaths = (
+			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-RNApp/Pods-RNApp-resources.sh\"\n";
@@ -437,7 +449,7 @@
 				CURRENT_PROJECT_VERSION = 1;
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = RNApp/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.1;
+				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
@@ -464,7 +476,7 @@
 				CLANG_ENABLE_MODULES = YES;
 				CURRENT_PROJECT_VERSION = 1;
 				INFOPLIST_FILE = RNApp/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.1;
+				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
@@ -507,7 +519,7 @@
 				GENERATE_INFOPLIST_FILE = YES;
 				INFOPLIST_KEY_NSHumanReadableCopyright = "";
 				INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks";
-				IPHONEOS_DEPLOYMENT_TARGET = 26.1;
+				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"@executable_path/Frameworks",
 					"@loader_path/Frameworks",
@@ -570,7 +582,7 @@
 				GENERATE_INFOPLIST_FILE = YES;
 				INFOPLIST_KEY_NSHumanReadableCopyright = "";
 				INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks";
-				IPHONEOS_DEPLOYMENT_TARGET = 26.1;
+				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"@executable_path/Frameworks",
 					"@loader_path/Frameworks",