navigation-native-navigators — правило для Claude Code: установка
Правило navigation-native-navigators для Claude Code направляет выбор навигации в React Native на нативные компоненты. Оно охватывает стеки, вкладки и заголовки экранов.
MIT ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settingsЧто делает navigation-native-navigators
Правило предлагает использовать нативные навигаторы вместо навигации на JavaScript. Для стеков оно указывает @react-navigation/native-stack или стек по умолчанию в expo-router, а для вкладок — react-native-bottom-tabs либо нативные вкладки expo-router.
Для заголовков правило советует выбирать встроенные параметры вместо собственного компонента. На iOS нативные вкладки автоматически настраивают отступы корневого ScrollView; отключить это поведение можно через disableAutomaticContentInsets.
Какие задачи решает
- заменить JS-стек навигации на нативный
- выбрать нативную реализацию вкладок
- настроить заголовок экрана встроенными параметрами
Примеры запросов агенту
- Настрой навигацию со стеком в React Native через нативный навигатор.
- Замени нижние вкладки на нативные для
expo-router. - Покажи, как задать заголовок экрана без собственного компонента.
Как установить navigation-native-navigators
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install react-skills@claude-settings2Вручную: положить файлы
.claude/rules/navigation-native-navigators.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/navigation-native-navigators.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/navigation-native-navigators.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/navigation-native-navigators.mdВручную: положить файлы
.clinerules/navigation-native-navigators.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о navigation-native-navigators
Как установить navigation-native-navigators в Claude Code?
Выполни /plugin marketplace add fcakyon/claude-codex-settings и затем /plugin install react-skills@claude-settings. Файл правила находится по пути .claude/rules/navigation-native-navigators.md.
Что делает navigation-native-navigators?
Правило направляет к нативным стекам и вкладкам в React Native и рекомендует встроенные параметры заголовков вместо пользовательского компонента.
Какие навигаторы правило рекомендует для стеков и вкладок?
Для стеков — @react-navigation/native-stack или стандартный стек expo-router. Для вкладок — react-native-bottom-tabs или нативные вкладки expo-router.
Исходный текст
navigation-native-navigators.md · MIT
---
title: Use Native Navigators for Navigation
impact: HIGH
impactDescription: native performance, platform-appropriate UI
tags: navigation, react-navigation, expo-router, native-stack, tabs
---
## Use Native Navigators for Navigation
Always use native navigators instead of JS-based ones. Native navigators use
platform APIs (UINavigationController on iOS, Fragment on Android) for better
performance and native behavior.
**For stacks:** Use `@react-navigation/native-stack` or expo-router's default
stack (which uses native-stack). Avoid `@react-navigation/stack`.
**For tabs:** Use `react-native-bottom-tabs` (native) or expo-router's native
tabs. Avoid `@react-navigation/bottom-tabs` when native feel matters.
### Stack Navigation
**Incorrect (JS stack navigator):**
```tsx
import { createStackNavigator } from '@react-navigation/stack'
const Stack = createStackNavigator()
function App() {
return (
<Stack.Navigator>
<Stack.Screen name='Home' component={HomeScreen} />
<Stack.Screen name='Details' component={DetailsScreen} />
</Stack.Navigator>
)
}
```
**Correct (native stack with react-navigation):**
```tsx
import { createNativeStackNavigator } from '@react-navigation/native-stack'
const Stack = createNativeStackNavigator()
function App() {
return (
<Stack.Navigator>
<Stack.Screen name='Home' component={HomeScreen} />
<Stack.Screen name='Details' component={DetailsScreen} />
</Stack.Navigator>
)
}
```
**Correct (expo-router uses native stack by default):**
```tsx
// app/_layout.tsx
import { Stack } from 'expo-router'
export default function Layout() {
return <Stack />
}
```
### Tab Navigation
**Incorrect (JS bottom tabs):**
```tsx
import { createBottomTabNavigator } from '@react-navigation/bottom-tabs'
const Tab = createBottomTabNavigator()
function App() {
return (
<Tab.Navigator>
<Tab.Screen name='Home' component={HomeScreen} />
<Tab.Screen name='Settings' component={SettingsScreen} />
</Tab.Navigator>
)
}
```
**Correct (native bottom tabs with react-navigation):**
```tsx
import { createNativeBottomTabNavigator } from '@bottom-tabs/react-navigation'
const Tab = createNativeBottomTabNavigator()
function App() {
return (
<Tab.Navigator>
<Tab.Screen
name='Home'
component={HomeScreen}
options={{
tabBarIcon: () => ({ sfSymbol: 'house' }),
}}
/>
<Tab.Screen
name='Settings'
component={SettingsScreen}
options={{
tabBarIcon: () => ({ sfSymbol: 'gear' }),
}}
/>
</Tab.Navigator>
)
}
```
**Correct (expo-router native tabs):**
```tsx
// app/(tabs)/_layout.tsx
import { NativeTabs } from 'expo-router/unstable-native-tabs'
export default function TabLayout() {
return (
<NativeTabs>
<NativeTabs.Trigger name='index'>
<NativeTabs.Trigger.Label>Home</NativeTabs.Trigger.Label>
<NativeTabs.Trigger.Icon sf='house.fill' md='home' />
</NativeTabs.Trigger>
<NativeTabs.Trigger name='settings'>
<NativeTabs.Trigger.Label>Settings</NativeTabs.Trigger.Label>
<NativeTabs.Trigger.Icon sf='gear' md='settings' />
</NativeTabs.Trigger>
</NativeTabs>
)
}
```
On iOS, native tabs automatically enable `contentInsetAdjustmentBehavior` on the
first `ScrollView` at the root of each tab screen, so content scrolls correctly
behind the translucent tab bar. If you need to disable this, use
`disableAutomaticContentInsets` on the trigger.
### Prefer Native Header Options Over Custom Components
**Incorrect (custom header component):**
```tsx
<Stack.Screen
name='Profile'
component={ProfileScreen}
options={{
header: () => <CustomHeader title='Profile' />,
}}
/>
```
**Correct (native header options):**
```tsx
<Stack.Screen
name='Profile'
component={ProfileScreen}
options={{
title: 'Profile',
headerLargeTitleEnabled: true,
headerSearchBarOptions: {
placeholder: 'Search',
},
}}
/>
```
Native headers support iOS large titles, search bars, blur effects, and proper
safe area handling automatically.
### Why Native Navigators
- **Performance**: Native transitions and gestures run on the UI thread
- **Platform behavior**: Automatic iOS large titles, Android material design
- **System integration**: Scroll-to-top on tab tap, PiP avoidance, proper safe
areas
- **Accessibility**: Platform accessibility features work automatically
Reference:
- [React Navigation Native Stack](https://reactnavigation.org/docs/native-stack-navigator)
- [React Native Bottom Tabs with React Navigation](https://oss.callstack.com/react-native-bottom-tabs/docs/guides/usage-with-react-navigation)
- [React Native Bottom Tabs with Expo Router](https://oss.callstack.com/react-native-bottom-tabs/docs/guides/usage-with-expo-router)
- [Expo Router Native Tabs](https://docs.expo.dev/router/advanced/native-tabs)
© fcakyon · MIT · fcakyon/claude-codex-settings