Claude Cursor Skill

react-native-architecture

Build production React Native apps with Expo, navigation, native modules, offline sync, and cross-platform patterns. Use when developing mobile apps, implementing native integrations, or architecting React Native projects.

LLM Mart · 0 points · 17 views 0 listing impressions 0 install-command copies
Download wshobson-agents-plugins_frontend-mobile-development_skills_react-native-architecture-554237f.zip · 6 KB

Install

skills CLI npx skills add https://github.com/wshobson/agents/tree/main/plugins/frontend-mobile-development/skills/react-native-architecture
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install wshobson-agents@llmmart
Git git clone https://github.com/wshobson/agents.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole wshobson/agents collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

React Native Architecture

Production-ready patterns for React Native development with Expo, including navigation, state management, native modules, and offline-first architecture.

When to Use This Skill

  • Starting a new React Native or Expo project
  • Implementing complex navigation patterns
  • Integrating native modules and platform APIs
  • Building offline-first mobile applications
  • Optimizing React Native performance
  • Setting up CI/CD for mobile releases

Core Concepts

1. Project Structure

src/
├── app/                    # Expo Router screens
│   ├── (auth)/            # Auth group
│   ├── (tabs)/            # Tab navigation
│   └── _layout.tsx        # Root layout
├── components/
│   ├── ui/                # Reusable UI components
│   └── features/          # Feature-specific components
├── hooks/                 # Custom hooks
├── services/              # API and native services
├── stores/                # State management
├── utils/                 # Utilities
└── types/                 # TypeScript types

2. Expo vs Bare React Native

Feature Expo Bare RN
Setup complexity Low High
Native modules EAS Build Manual linking
OTA updates Built-in Manual setup
Build service EAS Custom CI
Custom native code Config plugins Direct access

Quick Start

# Create new Expo project
npx create-expo-app@latest my-app -t expo-template-blank-typescript

# Install essential dependencies
npx expo install expo-router expo-status-bar react-native-safe-area-context
npx expo install @react-native-async-storage/async-storage
npx expo install expo-secure-store expo-haptics
// app/_layout.tsx
import { Stack } from 'expo-router'
import { ThemeProvider } from '@/providers/ThemeProvider'
import { QueryProvider } from '@/providers/QueryProvider'

export default function RootLayout() {
  return (
    <QueryProvider>
      <ThemeProvider>
        <Stack screenOptions={{ headerShown: false }}>
          <Stack.Screen name="(tabs)" />
          <Stack.Screen name="(auth)" />
          <Stack.Screen name="modal" options={{ presentation: 'modal' }} />
        </Stack>
      </ThemeProvider>
    </QueryProvider>
  )
}

Detailed patterns and worked examples

Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.

Best Practices

Do's

  • Use Expo - Faster development, OTA updates, managed native code
  • FlashList over FlatList - Better performance for long lists
  • Memoize components - Prevent unnecessary re-renders
  • Use Reanimated - 60fps animations on native thread
  • Test on real devices - Simulators miss real-world issues

Don'ts

  • Don't inline styles - Use StyleSheet.create for performance
  • Don't fetch in render - Use useEffect or React Query
  • Don't ignore platform differences - Test on both iOS and Android
  • Don't store secrets in code - Use environment variables
  • Don't skip error boundaries - Mobile crashes are unforgiving
Files (agents)
  • references
    • details.md 13.4 KB
      Loading…
  • SKILL.md 3.5 KB
    ---
    name: react-native-architecture
    description: Build production React Native apps with Expo, navigation, native modules, offline sync, and cross-platform patterns. Use when developing mobile apps, implementing native integrations, or architecting React Native projects.
    ---
    
    # React Native Architecture
    
    Production-ready patterns for React Native development with Expo, including navigation, state management, native modules, and offline-first architecture.
    
    ## When to Use This Skill
    
    - Starting a new React Native or Expo project
    - Implementing complex navigation patterns
    - Integrating native modules and platform APIs
    - Building offline-first mobile applications
    - Optimizing React Native performance
    - Setting up CI/CD for mobile releases
    
    ## Core Concepts
    
    ### 1. Project Structure
    
    ```
    src/
    ├── app/                    # Expo Router screens
    │   ├── (auth)/            # Auth group
    │   ├── (tabs)/            # Tab navigation
    │   └── _layout.tsx        # Root layout
    ├── components/
    │   ├── ui/                # Reusable UI components
    │   └── features/          # Feature-specific components
    ├── hooks/                 # Custom hooks
    ├── services/              # API and native services
    ├── stores/                # State management
    ├── utils/                 # Utilities
    └── types/                 # TypeScript types
    ```
    
    ### 2. Expo vs Bare React Native
    
    | Feature            | Expo           | Bare RN        |
    | ------------------ | -------------- | -------------- |
    | Setup complexity   | Low            | High           |
    | Native modules     | EAS Build      | Manual linking |
    | OTA updates        | Built-in       | Manual setup   |
    | Build service      | EAS            | Custom CI      |
    | Custom native code | Config plugins | Direct access  |
    
    ## Quick Start
    
    ```bash
    # Create new Expo project
    npx create-expo-app@latest my-app -t expo-template-blank-typescript
    
    # Install essential dependencies
    npx expo install expo-router expo-status-bar react-native-safe-area-context
    npx expo install @react-native-async-storage/async-storage
    npx expo install expo-secure-store expo-haptics
    ```
    
    ```typescript
    // app/_layout.tsx
    import { Stack } from 'expo-router'
    import { ThemeProvider } from '@/providers/ThemeProvider'
    import { QueryProvider } from '@/providers/QueryProvider'
    
    export default function RootLayout() {
      return (
        <QueryProvider>
          <ThemeProvider>
            <Stack screenOptions={{ headerShown: false }}>
              <Stack.Screen name="(tabs)" />
              <Stack.Screen name="(auth)" />
              <Stack.Screen name="modal" options={{ presentation: 'modal' }} />
            </Stack>
          </ThemeProvider>
        </QueryProvider>
      )
    }
    ```
    
    ## Detailed patterns and worked examples
    
    Detailed pattern documentation lives in `references/details.md`. Read that file when the navigation tier above is insufficient.
    
    ## Best Practices
    
    ### Do's
    
    - **Use Expo** - Faster development, OTA updates, managed native code
    - **FlashList over FlatList** - Better performance for long lists
    - **Memoize components** - Prevent unnecessary re-renders
    - **Use Reanimated** - 60fps animations on native thread
    - **Test on real devices** - Simulators miss real-world issues
    
    ### Don'ts
    
    - **Don't inline styles** - Use StyleSheet.create for performance
    - **Don't fetch in render** - Use useEffect or React Query
    - **Don't ignore platform differences** - Test on both iOS and Android
    - **Don't store secrets in code** - Use environment variables
    - **Don't skip error boundaries** - Mobile crashes are unforgiving
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.