feat: add brownfield navigation

[hurali97]

Summary

This adds the brownfield-navigation package which allows streamlining presenting native screens from react-native. The usage is as simple as:

• Add brownfield.navigation.ts:

export interface BrownfieldNavigationSpec {
  navigateToSettings(): void;
  navigateToReferrals(userId: string): void;
}

• Call functions from React Native

<Button
  title="Open native settings"
  onPress={() => BrownfieldNavigation.navigateToSettings()}
/>
<Button
  title="Open native referrals"
  onPress={() => BrownfieldNavigation.navigateToReferrals('user-123')}
/>

• Generate the AAR/XCFramework using brownfield-cli

That is all from react-native side, now ship the artifacts to the native team and they will do the final wiring, which is below steps.

---

• Create the delegate in your native App

// SwiftUI
public final class RNNavigationDelegate: BrownfieldNavigationDelegate {
  public func navigateToSettings() {
    present(SettingsScreen())
  }

  public func navigateToReferrals(userId: String) {
    present(ReferralsScreen(userId: userId))
  }

  private func present<Content: View>(_ view: Content) {
    // present VC
  }
}

• Register the delegate

init() {
  BrownfieldNavigationManager.shared.setDelegate(
    navigationDelegate: RNNavigationDelegate()
)

Test plan

• CI Passes - 🟢
• Verified Locally - 🟢

Android

Details

Screen.Recording.2026-02-26.at.5.07.46.PM.mov

iOS

Details

Simulator.Screen.Recording.-.iPhone.17.Pro.-.2026-02-26.at.16.28.57.mov

[hurali97]

Should we go with a major version bump? To maintain parity with react-native-brownfield, I have set the version to 3.0.0 for brownfield-navigation and doing a minor bump here.

[thymikee]

Always sync

[hurali97]

Bumped all minors to align.