react-native-navigation-builder
按照应用程序的嵌套导航器模式创建导航结构。在 Purrsuit 移动应用程序中处理类型安全的导航、堆栈和选项卡设置以及屏幕参数管理。
📖 中文导读:按照应用程序的嵌套导航器模式创建导航结构。在 Purrsuit 移动应用程序中处理类型安全的导航、堆栈和选项卡设置以及屏幕参数管理。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: react-native-navigation-builder description: Creates navigation structures following the app's nested navigator pattern. Handles type-safe navigation, stack and tab setup, and screen parameter management in Purrsuit Mobile App.
React Native Navigation Builder
This skill helps create and maintain the navigation structure of the Purrsuit Mobile App, ensuring type safety and consistency across nested navigators.
When to Use This Skill
Use this skill when you need to:
- Add a new screen to the
AppStackorMainTabs - Create a new nested navigator (e.g., a sub-stack or tabs)
- Define navigation types for new routes
- Set up screen props for components
- Configure navigation options (headers, tab bar, presentation modes)
Navigation Structure
The app uses a nested navigation structure:
- AppNavigator: The top-level
NavigationContainer. - AppStack: A
NativeStackcontaining global screens (Welcome, Legal, Modals) and theMainTabs. - MainTabs: A
BottomTabnavigator for the primary app features (Home, Capture, Map, Profile).
Type Safety
Defining Parameters
// app/navigators/navigationTypes.ts
export type AppStackParamList = {
Welcome: undefined
MainTabs: NavigatorScreenParams<MainTabParamList>
EncounterDetail: { encounterId: string }
// ...
}
Screen Props
export type AppStackScreenProps<T extends keyof AppStackParamList> =
NativeStackScreenProps<AppStackParamList, T>
export type MainTabScreenProps<T extends keyof MainTabParamList> =
CompositeScreenProps<
BottomTabScreenProps<MainTabParamList, T>,
AppStackScreenProps<keyof AppStackParamList>
>
Adding a New Screen
1. Update Param List
Add the screen name and its parameters to navigationTypes.ts.
2. Update Navigator
Add a <Stack.Screen> or <Tab.Screen> to the appropriate navigator file.
3. Implement Component
Use the defined props in your screen component:
export const MyNewScreen = (props: AppStackScreenProps<"MyNewScreen">) => {
const { navigation, route } = props
// ...
}
Common Patterns
Modal Presentation
<Stack.Screen
name="EncounterEdit"
component={EncounterEditScreen}
options={{ presentation: "modal" }}
/>
Tab Bar Icons
<Tab.Screen
name="Home"
component={HomeScreen}
options={{
tabBarLabel: "Home",
tabBarIcon: ({ color }) => <Home size={24} color={color} />,
}}
/>
References
See NAVIGATION_TYPES.md for detailed type patterns.
See NAVIGATOR_SETUP.md for stack and tab configuration examples.