React Native Navigation
Priority: P0 (CRITICAL)
Use React Navigation (official solution).
Build Type-Safe Navigation Stacks
- Architecture: Use Native Stack (
createNativeStackNavigator) by default for native performance. Only use JS Stack for custom transitions. - Typing: Use
NativeStackScreenPropsfor screens.CompositeScreenPropsfor nested Navigators.
See deep linking reference for typed param lists and stack navigator setup.
Configure Deep Linking
- Deep Linking: Use prefix arrays in
linkingconfig. Validate Universal Links (iOS) and App Links (Android). Handle unrecognized paths with 404 screen.
See deep linking reference for linking configuration with prefix arrays and fallback screens.
Implement Auth Flow
- Auth/App split: Conditionally render Auth Stack vs App Stack in
NavigationContainer. Clear navigation state after logout. - Logic: Use Tab Navigators for bottom navigation. Drawer for side menus.
- Transitions: Native-like feel via
presentation: 'modal'. CustomheaderLeft/Rightinoptions. - Data Flow: Use
route.paramsfor small IDs only. Use global state (Zustand/RTK) for complex data objects.
Anti-Patterns
- No String Literals: Use typed params.
- No Navigation in Business Logic: Pass callbacks from screens.
- No Deep Nesting: Max 2-3 levels of navigators.
References
See references/deep-linking.md for typed param lists, Universal Links, Nested Navigators, and State Persistence.