# wix/react-native-navigation architecture

> Architecture diagram of the GitHub repository wix/react-native-navigation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wix/react-native-navigation
- Repository: https://github.com/wix/react-native-navigation

## Overview

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: [`android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java`](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java) (Parent Controller), [`src/Navigation.ts`](https://github.com/wix/react-native-navigation/blob/master/src/Navigation.ts) (Navigation API), [`android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/ViewController.java`](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/ViewController.java) (View Controller), [`android/src/main/java/com/reactnativenavigation/react/NavigationModule.java`](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/react/NavigationModule.java) (Native Module)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_js["JavaScript API"]
  node_navigation["Navigation API<br/>[Navigation.ts]"]
  node_layout_parser["Layout Parser"]
  node_options_processor["Options Processor"]
  node_linking["Deep Linking<br/>[LinkingHandler.ts]"]
end

subgraph group_android["Android Navigation"]
  node_native_module["Native Module"]
  node_options["Navigation Options<br/>[Options.java]"]
  node_stack["Stack Controller"]
  node_tabs["Bottom Tabs"]
  node_parent["Parent Controller"]
  node_child_registry[("Child Registry")]
  node_view_controller["View Controller"]
end

subgraph group_presentation["Native Presentation"]
  node_presenter["Presenter<br/>[Presenter.java]"]
  node_topbar["Top Bar"]
  node_component_view["React Component View<br/>[ReactView.java]"]
  node_modal["Modal Presentation<br/>[ModalStack.java]"]
  node_side_menu["Side Menu"]
end

subgraph group_ios["iOS Platform"]
  node_ios_navigation["iOS Navigation"]
end

node_app(("React Native App"))

node_app -.->|"issues commands"| node_navigation
node_navigation -.->|"parses layouts"| node_layout_parser
node_navigation -.->|"processes options"| node_options_processor
node_navigation -->|"handles links"| node_linking
node_navigation -.->|"bridges commands"| node_native_module
node_native_module -.->|"dispatches commands"| node_stack
node_native_module -.->|"dispatches commands"| node_tabs
node_stack -->|"extends behavior"| node_parent
node_tabs -->|"extends behavior"| node_parent
node_parent -.->|"tracks children"| node_child_registry
node_parent -->|"manages children"| node_view_controller
node_parent -->|"resolves options"| node_options
node_view_controller -.->|"applies presentation"| node_presenter
node_stack -->|"coordinates bar"| node_topbar
node_view_controller -.->|"hosts component"| node_component_view
node_app -->|"uses native navigation"| node_ios_navigation
node_modal -.->|"presents screens"| node_view_controller
node_side_menu -.->|"organizes children"| node_parent

click node_navigation "https://github.com/wix/react-native-navigation/blob/master/src/Navigation.ts"
click node_layout_parser "https://github.com/wix/react-native-navigation/blob/master/src/commands/LayoutTreeParser.ts"
click node_options_processor "https://github.com/wix/react-native-navigation/blob/master/src/commands/OptionsProcessor.ts"
click node_linking "https://github.com/wix/react-native-navigation/blob/master/src/linking/LinkingHandler.ts"
click node_native_module "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/react/NavigationModule.java"
click node_options "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/options/Options.java"
click node_stack "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/StackController.java"
click node_tabs "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/bottomtabs/BottomTabsController.java"
click node_parent "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java"
click node_child_registry "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/child/ChildControllersRegistry.java"
click node_view_controller "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/ViewController.java"
click node_presenter "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/Presenter.java"
click node_topbar "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/topbar/TopBarController.kt"
click node_component_view "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/react/ReactView.java"
click node_modal "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/modal/ModalStack.java"
click node_side_menu "https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/sidemenu/SideMenuController.java"
click node_ios_navigation "https://github.com/wix/react-native-navigation/blob/master/ios/RNNComponentViewController.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_navigation,node_layout_parser,node_options_processor,node_linking toneBlue
class node_native_module,node_options,node_stack,node_tabs,node_parent,node_child_registry,node_view_controller toneAmber
class node_presenter,node_topbar,node_component_view,node_modal,node_side_menu toneMint
class node_ios_navigation toneRose
class node_app toneIndigo
```

## Components

### JavaScript API

- [Navigation API](https://github.com/wix/react-native-navigation/blob/master/src/Navigation.ts): `src/Navigation.ts`
- [Layout Parser](https://github.com/wix/react-native-navigation/blob/master/src/commands/LayoutTreeParser.ts): `src/commands/LayoutTreeParser.ts`
- [Options Processor](https://github.com/wix/react-native-navigation/blob/master/src/commands/OptionsProcessor.ts): `src/commands/OptionsProcessor.ts`
- [Deep Linking](https://github.com/wix/react-native-navigation/blob/master/src/linking/LinkingHandler.ts): `src/linking/LinkingHandler.ts`

### Android Navigation

- [Native Module](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/react/NavigationModule.java): `android/src/main/java/com/reactnativenavigation/react/NavigationModule.java`
- [Navigation Options](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/options/Options.java): `android/src/main/java/com/reactnativenavigation/options/Options.java`
- [Stack Controller](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/StackController.java): `android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/StackController.java`
- [Bottom Tabs](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/bottomtabs/BottomTabsController.java): `android/src/main/java/com/reactnativenavigation/viewcontrollers/bottomtabs/BottomTabsController.java`
- [Parent Controller](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java): `android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java`
- [Child Registry](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/child/ChildControllersRegistry.java): `android/src/main/java/com/reactnativenavigation/viewcontrollers/child/ChildControllersRegistry.java`
- [View Controller](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/ViewController.java): `android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/ViewController.java`

### Native Presentation

- [Presenter](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/Presenter.java): `android/src/main/java/com/reactnativenavigation/viewcontrollers/viewcontroller/Presenter.java`
- [Top Bar](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/topbar/TopBarController.kt): `android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/topbar/TopBarController.kt`
- [React Component View](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/react/ReactView.java): `android/src/main/java/com/reactnativenavigation/react/ReactView.java`
- [Modal Presentation](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/modal/ModalStack.java): `android/src/main/java/com/reactnativenavigation/viewcontrollers/modal/ModalStack.java`
- [Side Menu](https://github.com/wix/react-native-navigation/blob/master/android/src/main/java/com/reactnativenavigation/viewcontrollers/sidemenu/SideMenuController.java): `android/src/main/java/com/reactnativenavigation/viewcontrollers/sidemenu/SideMenuController.java`

### iOS Platform

- [iOS Navigation](https://github.com/wix/react-native-navigation/blob/master/ios/RNNComponentViewController.h): `ios/RNNComponentViewController.h`

### Other components

- **React Native App**

## Connections

- React Native App → Navigation API: issues commands (evidence: `README.md`)
- Navigation API → Layout Parser: parses layouts
- Navigation API → Options Processor: processes options
- Navigation API → Deep Linking: handles links (evidence: `src/linking/LinkingHandler.ts`)
- Navigation API → Native Module: bridges commands (evidence: `README.md`)
- Native Module → Stack Controller: dispatches commands
- Native Module → Bottom Tabs: dispatches commands
- Stack Controller → Parent Controller: extends behavior (evidence: `android/src/main/java/com/reactnativenavigation/viewcontrollers/stack/StackController.java`)
- Bottom Tabs → Parent Controller: extends behavior (evidence: `android/src/main/java/com/reactnativenavigation/viewcontrollers/bottomtabs/BottomTabsController.java`)
- Parent Controller → Child Registry: tracks children (evidence: `android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java`)
- Parent Controller → View Controller: manages children (evidence: `android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java`)
- Parent Controller → Navigation Options: resolves options (evidence: `android/src/main/java/com/reactnativenavigation/viewcontrollers/parent/ParentController.java`)
- View Controller → Presenter: applies presentation
- Stack Controller → Top Bar: coordinates bar (evidence: `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 (evidence: `README.md`)
- Modal Presentation → View Controller: presents screens
- Side Menu → Parent Controller: organizes children (evidence: `android/src/main/java/com/reactnativenavigation/viewcontrollers/sidemenu/SideMenuController.java`)
