How wix/react-native-navigation works
React Native Navigation is a cross-platform library for native navigation in React Native apps. The principal workflow starts with an app issuing a JavaScript navigation command, which is translated into a layout/options representation and handled by native navigation controllers that present React components. The Android excerpts show stack and tab behavior, parent-child option resolution, and presenter responsibilities; the README documents native navigation on both platforms. Several JavaScript and iOS implementation relationships are not evidenced by the excerpts, so uncertain links are omitted or marked unverified.
Main entry points: ParentController.java Parent Controller · Navigation.ts Navigation API · ViewController.java View Controller · NavigationModule.java Native Module
Components 18
JavaScript API
- Navigation API
src/Navigation.ts - Layout Parser
src/commands/LayoutTreeParser.ts - Options Processor
src/commands/OptionsProcessor.ts - Deep Linking
src/linking/LinkingHandler.ts
Android Navigation
- Native Module
android/src/main/java/com/reactnativenavigation/react/NavigationModule.java - Navigation Options
android/src/main/java/com/reactnativenavigation/options/Options.java - Stack Controller
android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/StackController.java - Bottom Tabs
android/src/main/java/com/reactnativenavigation/viewcontrollers/bottomtabs/BottomTabsController.java - Parent Controller
android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java - Child Registry
android/src/main/java/com/reactnativenavigation/viewcontrollers/child/ChildControllersRegistry.java - View Controller
android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/ViewController.java
Native Presentation
- Presenter
android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/Presenter.java - Top Bar
android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/topbar/TopBarController.kt - React Component View
android/src/main/java/com/reactnativenavigation/react/ReactView.java - Modal Presentation
android/src/main/java/com/reactnativenavigation/viewcontrollers/modal/ModalStack.java - Side Menu
android/src/main/java/com/reactnativenavigation/viewcontrollers/sidemenu/SideMenuController.java
iOS Platform
- iOS Navigation
ios/RNNComponentViewController.h
Other components
- React Native App
Connections 18
- React Native App → Navigation API: issues commands
README.md - Navigation API → Layout Parser: parses layouts
- Navigation API → Options Processor: processes options
- Navigation API → Deep Linking: handles links
src/linking/LinkingHandler.ts - Navigation API → Native Module: bridges commands
README.md - Native Module → Stack Controller: dispatches commands
- Native Module → Bottom Tabs: dispatches commands
- Stack Controller → Parent Controller: extends behavior
android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/StackController.java - Bottom Tabs → Parent Controller: extends behavior
android/src/main/java/com/reactnativenavigation/viewcontrollers/bottomtabs/BottomTabsController.java - Parent Controller → Child Registry: tracks children
android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java - Parent Controller → View Controller: manages children
android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java - Parent Controller → Navigation Options: resolves options
android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java - View Controller → Presenter: applies presentation
- Stack Controller → Top Bar: coordinates bar
android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/StackController.java - View Controller → React Component View: hosts component
- React Native App → iOS Navigation: uses native navigation
README.md - Modal Presentation → View Controller: presents screens
- Side Menu → Parent Controller: organizes children
android/src/main/java/com/reactnativenavigation/viewcontrollers/sidemenu/SideMenuController.java