К основному содержанию
скилл CX Codex

react-native · gentleman-programming — скилл для Claude Code: мобильная разработка с Expo

Скилл с паттернами React Native для кроссплатформенной мобильной разработки. Включает типизированные компоненты, навигацию, стилизацию через NativeWind и управление состоянием.

MIT 263 установок ★ 678 обновлён 2026-03-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Gentleman-Programming/Gentleman-Skills --skill react-native -a claude-code
Открыть на GitHub

Что делает react-native

Скилл предоставляет готовые паттерны для работы с React Native: структура проекта, функциональные компоненты с типизацией TypeScript, платформоспецифичный код для iOS и Android. Внутри есть примеры использования Expo Router для навигации, кастомные хуки с React Query, стилизация через NativeWind (Tailwind для React Native), обработка клавиатуры и безопасных областей экрана.

Основные инструменты в скилле: expo-router для навигации, @tanstack/react-query для кэширования данных, zustand для состояния с персистентностью через AsyncStorage, nativewind для Tailwind-стилей. Скилл сфокусирован на функциональных компонентах и демонстрирует, как разделить код между iOS и Android через Platform.select или расширения файлов.

Какие задачи решает

  • писать типизированные функциональные компоненты с правильной структурой
  • настроить навигацию между экранами с группами маршрутов
  • применить платформоспецифичный код для iOS и Android
  • стилизовать компоненты через Tailwind с NativeWind
  • управлять состоянием приложения и кэшировать данные API

Примеры запросов агенту

  • Создай форму входа с клавиатурой по краям экрана
  • Настрой навигацию с вкладками и модальными окнами в Expo Router
  • Напиши кастомный хук для загрузки данных пользователя через React Query

Как установить react-native

1Через Skills CLI (Vercel)

npx skills add Gentleman-Programming/Gentleman-Skills --skill react-native -a claude-code

2Вручную: положить файлы

~/.claude/skills/react-native/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/react-native/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о react-native

Как установить react-native скилл в Claude Code?

Выполни npx skills add Gentleman-Programming/Gentleman-Skills --skill react-native -a claude-code, потом открой файл ~/.claude/skills/react-native/SKILL.md.

Что делает скилл react-native?

Предоставляет паттерны для мобильной разработки: структуру проекта, типизированные компоненты, примеры навигации, платформоспецифичный код, стилизацию и управление состоянием.

Какие библиотеки использует этот скилл?

Основные: Expo Router, React Query, Zustand, NativeWind, react-native-safe-area-context. Скилл показывает, как их объединить в реальном проекте.

Исходный текст

SKILL.md · MIT
---
name: react-native
description: >
  React Native patterns for mobile app development with Expo and bare workflow.
  Trigger: When building mobile apps, working with React Native components, using Expo, React Navigation, or NativeWind.
metadata:
  author: gentleman-programming
  version: "1.0"
---

## When to Use

Load this skill when:
- Building mobile applications with React Native
- Working with Expo managed or bare workflow
- Implementing navigation with React Navigation
- Styling with NativeWind (Tailwind for RN)
- Handling platform-specific code (iOS/Android)
- Managing native modules and linking

## Critical Patterns

### Pattern 1: Project Structure

```
src/
├── app/                    # Expo Router screens (if using)
│   ├── (tabs)/            # Tab navigator group
│   ├── (auth)/            # Auth flow group
│   └── _layout.tsx        # Root layout
├── components/
│   ├── ui/                # Reusable UI components
│   └── features/          # Feature-specific components
├── hooks/                 # Custom hooks
├── services/              # API and external services
├── stores/                # State management (Zustand)
├── utils/                 # Utility functions
├── constants/             # App constants, themes
└── types/                 # TypeScript types
```

### Pattern 2: Functional Components with TypeScript

Always use functional components with proper typing:

```typescript
import { View, Text, Pressable } from 'react-native';
import type { ViewStyle, TextStyle } from 'react-native';

interface ButtonProps {
  title: string;
  onPress: () => void;
  variant?: 'primary' | 'secondary';
  disabled?: boolean;
}

export function Button({ 
  title, 
  onPress, 
  variant = 'primary',
  disabled = false 
}: ButtonProps) {
  return (
    <Pressable
      onPress={onPress}
      disabled={disabled}
      style={({ pressed }) => [
        styles.button,
        variant === 'secondary' && styles.buttonSecondary,
        pressed && styles.buttonPressed,
        disabled && styles.buttonDisabled,
      ]}
    >
      <Text style={styles.buttonText}>{title}</Text>
    </Pressable>
  );
}
```

### Pattern 3: Platform-Specific Code

Use Platform module or file extensions for platform-specific code:

```typescript
import { Platform, StyleSheet } from 'react-native';

// Using Platform.select
const styles = StyleSheet.create({
  container: {
    paddingTop: Platform.select({
      ios: 44,
      android: 0,
    }),
    ...Platform.select({
      ios: {
        shadowColor: '#000',
        shadowOffset: { width: 0, height: 2 },
        shadowOpacity: 0.1,
        shadowRadius: 4,
      },
      android: {
        elevation: 4,
      },
    }),
  },
});

// Or use file extensions:
// Component.ios.tsx
// Component.android.tsx
```

## Code Examples

### Example 1: Expo Router Navigation Setup

```typescript
// app/_layout.tsx
import { Stack } from 'expo-router';
import { StatusBar } from 'expo-status-bar';

export default function RootLayout() {
  return (
    <>
      <StatusBar style="auto" />
      <Stack
        screenOptions={{
          headerShown: false,
          animation: 'slide_from_right',
        }}
      >
        <Stack.Screen name="(tabs)" options={{ headerShown: false }} />
        <Stack.Screen 
          name="modal" 
          options={{ 
            presentation: 'modal',
            animation: 'slide_from_bottom',
          }} 
        />
      </Stack>
    </>
  );
}
```

### Example 2: Custom Hook with React Query

```typescript
// hooks/useUser.ts
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
import { userService } from '@/services/user';
import type { User, UpdateUserInput } from '@/types';

export function useUser(userId: string) {
  return useQuery({
    queryKey: ['user', userId],
    queryFn: () => userService.getById(userId),
    staleTime: 5 * 60 * 1000, // 5 minutes
  });
}

export function useUpdateUser() {
  const queryClient = useQueryClient();

  return useMutation({
    mutationFn: (data: UpdateUserInput) => userService.update(data),
    onSuccess: (_, variables) => {
      queryClient.invalidateQueries({ queryKey: ['user', variables.id] });
    },
  });
}
```

### Example 3: NativeWind Styling

```typescript
// With NativeWind (Tailwind for React Native)
import { View, Text, Pressable } from 'react-native';
import { styled } from 'nativewind';

const StyledPressable = styled(Pressable);
const StyledView = styled(View);
const StyledText = styled(Text);

export function Card({ title, description, onPress }: CardProps) {
  return (
    <StyledPressable
      className="bg-white dark:bg-gray-800 rounded-2xl p-4 shadow-md active:scale-95"
      onPress={onPress}
    >
      <StyledView className="flex-row items-center gap-3">
        <StyledView className="w-12 h-12 bg-blue-100 dark:bg-blue-900 rounded-full items-center justify-center">
          <StyledText className="text-blue-600 dark:text-blue-300 text-xl">
            📱
          </StyledText>
        </StyledView>
        <StyledView className="flex-1">
          <StyledText className="text-lg font-semibold text-gray-900 dark:text-white">
            {title}
          </StyledText>
          <StyledText className="text-sm text-gray-500 dark:text-gray-400">
            {description}
          </StyledText>
        </StyledView>
      </StyledView>
    </StyledPressable>
  );
}
```

### Example 4: Safe Area and Keyboard Handling

```typescript
import { KeyboardAvoidingView, Platform } from 'react-native';
import { SafeAreaView } from 'react-native-safe-area-context';

export function ScreenWrapper({ children }: { children: React.ReactNode }) {
  return (
    <SafeAreaView style={{ flex: 1 }} edges={['top', 'left', 'right']}>
      <KeyboardAvoidingView
        style={{ flex: 1 }}
        behavior={Platform.OS === 'ios' ? 'padding' : 'height'}
        keyboardVerticalOffset={Platform.OS === 'ios' ? 0 : 20}
      >
        {children}
      </KeyboardAvoidingView>
    </SafeAreaView>
  );
}
```

### Example 5: Zustand Store with Persistence

```typescript
// stores/authStore.ts
import { create } from 'zustand';
import { persist, createJSONStorage } from 'zustand/middleware';
import AsyncStorage from '@react-native-async-storage/async-storage';

interface AuthState {
  token: string | null;
  user: User | null;
  isAuthenticated: boolean;
  login: (token: string, user: User) => void;
  logout: () => void;
}

export const useAuthStore = create<AuthState>()(
  persist(
    (set) => ({
      token: null,
      user: null,
      isAuthenticated: false,
      login: (token, user) => set({ token, user, isAuthenticated: true }),
      logout: () => set({ token: null, user: null, isAuthenticated: false }),
    }),
    {
      name: 'auth-storage',
      storage: createJSONStorage(() => AsyncStorage),
    }
  )
);
```

## Anti-Patterns

### Don't: Inline Styles Everywhere

```typescript
// ❌ Bad - inline styles are hard to maintain and don't memoize
export function BadComponent() {
  return (
    <View style={{ flex: 1, padding: 16, backgroundColor: '#fff' }}>
      <Text style={{ fontSize: 18, fontWeight: 'bold', color: '#333' }}>
        Title
      </Text>
    </View>
  );
}

// ✅ Good - use StyleSheet or NativeWind
const styles = StyleSheet.create({
  container: { flex: 1, padding: 16, backgroundColor: '#fff' },
  title: { fontSize: 18, fontWeight: 'bold', color: '#333' },
});

export function GoodComponent() {
  return (
    <View style={styles.container}>
      <Text style={styles.title}>Title</Text>
    </View>
  );
}
```

### Don't: Use TouchableOpacity for Everything

```typescript
// ❌ Bad - TouchableOpacity is legacy
import { TouchableOpacity } from 'react-native';

// ✅ Good - Use Pressable with feedback
import { Pressable } from 'react-native';

<Pressable
  onPress={onPress}
  style={({ pressed }) => [
    styles.button,
    pressed && { opacity: 0.7 }
  ]}
>
  {({ pressed }) => (
    <Text style={pressed ? styles.textPressed : styles.text}>
      Press Me
    </Text>
  )}
</Pressable>
```

### Don't: Forget to Handle Loading and Error States

```typescript
// ❌ Bad - no loading/error handling
export function UserProfile({ userId }: { userId: string }) {
  const { data } = useUser(userId);
  return <Text>{data.name}</Text>; // Will crash if data is undefined
}

// ✅ Good - handle all states
export function UserProfile({ userId }: { userId: string }) {
  const { data, isLoading, error } = useUser(userId);

  if (isLoading) return <LoadingSpinner />;
  if (error) return <ErrorMessage error={error} />;
  if (!data) return null;

  return <Text>{data.name}</Text>;
}
```

## Quick Reference

| Task | Pattern |
|------|---------|
| Create new Expo project | `npx create-expo-app@latest --template tabs` |
| Add NativeWind | `npx expo install nativewind tailwindcss` |
| Platform check | `Platform.OS === 'ios'` |
| Safe insets | `useSafeAreaInsets()` from `react-native-safe-area-context` |
| Navigation | `router.push('/screen')` with Expo Router |
| Deep linking | Configure in `app.json` under `expo.scheme` |
| Environment vars | Use `expo-constants` or `react-native-dotenv` |
| Icons | `@expo/vector-icons` (included in Expo) |
| Animations | `react-native-reanimated` for 60fps animations |
| Gestures | `react-native-gesture-handler` |

## Resources

- [Expo Documentation](https://docs.expo.dev/)
- [React Native Documentation](https://reactnative.dev/docs/getting-started)
- [Expo Router](https://expo.github.io/router/docs/)
- [NativeWind](https://www.nativewind.dev/)
- [React Navigation](https://reactnavigation.org/docs/getting-started)

© gentleman-programming · MIT · Gentleman-Programming/Gentleman-Skills

Похожие скиллы

Все скиллы по теме «Мобильная разработка» →

Сначала — react-native от других авторов.

react-native vercel-labs Собирает нативные React Native-интерфейсы из JSON-спецификаций. Задаёт мобильный UI с состоянием, условиями видимости и действиями. CX Codex +1 3 300установок react-native jezweb Набор архитектурных правил и паттернов производительности для React Native и Expo. Помогает агенту оптимизировать списки, настраивать анимации и экраны. CX Codex +1 1 300установок react-native alinaqi Задаёт структуру проекта, паттерны компонентов и правила тестирования для React Native. Подключается автоматически при работе с .tsx-файлами или каталогами ios/ и android/. CX Codex +1 575установок react-native assistant-ui Скилл для сборки мобильного чата с AI SDK v7 в Expo и React Native через @assistant-ui/react-native. Агент настраивает рантайм, примитивы ThreadPrimitive, ComposerPrimitive, стили и абсолютный эндпоинт API. CX Codex +1 1 200установок react-native travisjneuman Помогает разрабатывать приложения на React Native и Expo для iOS и Android. Подключается к задачам с JavaScript или TypeScript, нативными функциями и производительностью. CX Codex +1 157установок expo-react-native-typescript Mindrally Скилл expo-react-native-typescript задаёт агенту правила разработки мобильных приложений на Expo, React Native и TypeScript: структура файлов, навигация, состояние, тесты. CX Codex +1 2 300установок react-native-expert https://github.com/Jeffallan Скилл react-native-expert для агентов ИИ-кодинга: помогает собирать мобильные приложения на React Native и Expo — навигация, нативные модули, скорость списков, код под iOS и Android. CX Codex +1 5 300установок expo-react-native-coder pproenca Скилл expo-react-native-coder с 50 правилами и шаблонами кода для разработки мобильных приложений на Expo и React Native. Пригодится при сборке экранов, навигации и авторизации. CX Codex +1 423установок react-native-unistyles-v3 jpudysz Скилл объясняет агенту, как писать стили на react-native-unistyles v3: темы, breakpoints, variants и правила, на которых ломается C++-ядро. CX Codex +1 722установок react-native-expo-cursorrules-prompt-file PatrickJS react-native-expo-cursorrules-prompt-file — правило для Cursor, задающее стек и структуру проекта на React Native с Expo. Оно помогает агенту соблюдать единый стиль кода. CX Codex +1 ★ 41 178звёзд репо expo-react-native-expert VoltAgent Community Субагент expo-react-native-expert помогает проектировать и писать мобильные приложения на Expo SDK 52+ и React Native 0.76+. Настраивает маршрутизацию Expo Router, нативные модули и пайплайны сборки в EAS. CX Codex ★ 26 718звёзд репо

Из того же набора20

Весь набор →
angular-performance Скилл angular-performance для Angular: подсказывает, как грузить картинки через NgOptimizedImage, откладывать тяжёлые компоненты через @defer и настроить SSR с гидратацией. CX Codex +1 353установок java-21 Учит генерировать код на Java 21 через records, sealed-типы и виртуальные потоки. Включается при работе с иммутабельными DTO, закрытыми иерархиями и блокирующим вводом-выводом. CX Codex +1 330установок angular-architecture Скилл angular-architecture задаёт правила, куда класть компоненты Angular, как называть файлы и что менять в официальном стайлгайде. CX Codex +1 322установок pytest Добавляет шаблоны тестов на pytest: фикстуры, моки, маркеры и параметризацию. Помогает агенту писать тесты для Python-кода. CX Codex +1 291установок hexagonal-architecture-layers-java Скилл hexagonal-architecture-layers-java раскладывает Java-сервис по слоям Domain, Application и Infrastructure. Нужен при создании сервиса или рефакторинге Spring-кода. CX Codex +1 250установок angular-core Скилл angular-core учит агента современным паттернам Angular: standalone-компоненты, сигналы вместо хуков, zoneless-режим и встроенный control flow. CX Codex +1 230установок jira-task Скилл jira-task автоматизирует создание задач в Jira по стандарту Prowler. Генерирует структурированные баги, фичи и рефакторинги с правильными заголовками, критериями приёма и разбивкой по компонентам. CX Codex +1 217установок github-pr Скилл github-pr задаёт правила оформления пулл-реквестов по стандарту Conventional Commits и готовит вызовы gh pr create без рутины. CX Codex +1 205установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой