| name | react-native-navigation |
| description | Configure stack navigation, type-safe routes, deep linking, and URL-based routing with React Navigation in React Native. Use for React Navigation route configuration; defer unrelated performance, notification, build, and styling work. |
| metadata | {"triggers":{"files":["**/App.tsx","**/*Navigator.tsx","**/*Screen.tsx"],"keywords":["NavigationContainer","createNativeStackNavigator","createBottomTabNavigator","linking","deep link"]}} |
React Native Navigation — Deep Linking
Priority: P1 (HIGH)
Deep-linking companion to react-native-navigation-v6, which owns stack/tab/drawer setup and auth-flow structure. For new Expo projects, prefer Expo Router (file-based, built on React Navigation) — see react-native-architecture for the decision criteria.
Configure Type-Safe Navigation
- Library: Use
@react-navigation/native-stack for native performance.
- Type Safety: Define
RootStackParamList for all navigators.
- Deep Links: Configure
linking prop in NavigationContainer.
- Validation: Validate route parameters (
route.params) before fetching data.
See routing patterns for type-safe stack setup and deep linking configuration.
Anti-Patterns
- No Untyped Navigation:
navigation.navigate('Unknown') leads to errors. Use typed params.
- No Manual URL Parsing: Use
linking.config, not manual string parsing.
- No Unvalidated Deep Links: Handle invalid IDs gracefully (e.g., redirect to Home/404).
References
See references/routing-patterns.md for typed param lists and deep linking config.
Canonical response anchors
When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:
