Agent-skills-standard react-native-navigation-v6

Configure React Navigation 6+ stacks, tabs, and deep linking for React Native. Use when implementing React Navigation stacks, tabs, or deep linking in React Native. (triggers: **/*Navigation*.tsx, src/navigation/**, navigation, react-navigation, stack, tab, drawer, deep link)

install
source · Clone the upstream repo
git clone https://github.com/HoangNguyen0403/agent-skills-standard
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/HoangNguyen0403/agent-skills-standard "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/react-native/react-native-navigation-v6" ~/.claude/skills/hoangnguyen0403-agent-skills-standard-react-native-navigation-v6 && rm -rf "$T"
manifest: skills/react-native/react-native-navigation-v6/SKILL.md
source content

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
    NativeStackScreenProps
    for screens.
    CompositeScreenProps
    for nested Navigators.

See deep linking reference for typed param lists and stack navigator setup.

Configure Deep Linking

  • Deep Linking: Use prefix arrays in
    linking
    config. 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'
    . Custom
    headerLeft/Right
    in
    options
    .
  • Data Flow: Use
    route.params
    for 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.