Skip to main content
skill CX Codex

react-native · oakoss — Claude Code skill: what it does, how to install

Guides agents in building React Native and Expo apps for iOS, Android, and web using file-based routing, EAS workflows, and native device modules.

MIT 117 installs ★ 29 updated 2026-08-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add oakoss/agent-skills --skill react-native -a claude-code
Open on GitHub

What react-native does

This skill equips coding agents with conventions for modern React Native development on top of the Expo framework. It covers navigation architecture with Expo Router, including layout files, stack and tab navigators, and drawer setups using typed routes.

Guidance also spans build pipelines and native integrations. It details cloud builds via EAS Build, app store distribution with EAS Submit, and over-the-air JS delivery using eas update. For hardware interactions, the instructions enforce permission flows before accessing device APIs like expo-camera, expo-notifications, and expo-haptics.

Native dependency updates strictly require running eas build, since OTA delivery through eas update cannot apply native binary changes.

What it helps with

  • set up file-based tabs and stack navigation with Expo Router
  • configure automated mobile builds and deployments via EAS
  • handle runtime permissions for camera and push notifications
  • style cross-platform components with NativeWind v4 utility classes

Example prompts for the agent

  • Build a settings screen with push notification toggles and haptic feedback
  • Configure an Expo Router layout group with typed navigation tabs
  • Draft an EAS build configuration for iOS production distribution

How to install react-native

1Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill react-native -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/react-native/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about react-native

How to install react-native in Claude Code?

Run npx skills add oakoss/agent-skills --skill react-native -a claude-code in your terminal.

What does the react-native skill do?

It guides the agent on Expo and React Native patterns, covering Expo Router, EAS workflows, NativeWind styling, and device APIs.

When should this skill be avoided?

Skip it for brownfield integrations into existing native apps or projects with heavy custom native code incompatible with the Expo Modules API.

Source text

SKILL.md · MIT
---
name: react-native
description: |
  React Native with Expo framework for building native mobile apps on Android, iOS, and web from a single TypeScript codebase. Covers Expo Router file-based navigation (stack, tabs, drawer), EAS Build/Submit/Update for CI/CD and OTA updates, expo-dev-client for custom development builds, Expo Modules API for native Swift/Kotlin modules, core RN patterns (StyleSheet, FlatList, Platform-specific code), native device APIs (camera, notifications, haptics), and NativeWind for Tailwind CSS styling.

  Use when building React Native apps with Expo, configuring Expo Router navigation, setting up EAS Build pipelines, implementing OTA updates, creating native modules, or integrating device APIs like camera and push notifications.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://docs.expo.dev'
user-invocable: false
---

# React Native with Expo

## Overview

Expo is an open-source framework for building universal native apps with React Native from a single TypeScript codebase. It provides file-based routing (Expo Router), cloud build services (EAS Build/Submit/Update), and a rich set of native modules for device APIs.

**When to use:** Mobile apps targeting iOS and Android, universal apps with web support, projects needing OTA updates, apps requiring native device APIs (camera, notifications, haptics), teams preferring managed infrastructure over bare React Native.

**When NOT to use:** Apps requiring heavy custom native code incompatible with Expo Modules API, brownfield integration into existing native apps, apps with native-only CI/CD requirements.

## Quick Reference

| Pattern           | API                                  | Key Points                                  |
| ----------------- | ------------------------------------ | ------------------------------------------- |
| Stack navigation  | `<Stack>` from `expo-router`         | File-based, `_layout.tsx` defines navigator |
| Tab navigation    | `<Tabs>` from `expo-router`          | `(tabs)` directory group with `_layout.tsx` |
| Drawer navigation | `<Drawer>` from `expo-router/drawer` | Requires `@react-navigation/drawer`         |
| Typed routes      | `href` with `/(group)/route`         | Enable `typed-routes` in `app.json`         |
| Dev build         | `expo-dev-client`                    | Custom native code + dev tools              |
| EAS Build         | `eas build --profile production`     | Cloud builds for app stores                 |
| EAS Submit        | `eas submit -p ios` / `-p android`   | Automated store submission                  |
| OTA Update        | `eas update --branch production`     | JS-only updates, no rebuild needed          |
| Native module     | Expo Modules API                     | Swift/Kotlin with `expo-module.config.json` |
| Platform code     | `Platform.select()` / `.ios.tsx`     | Per-platform logic or entire files          |
| Styled lists      | `FlatList` / `FlashList`             | Virtualized, `keyExtractor` required        |
| Camera            | `expo-camera`                        | Permissions via `useCameraPermissions()`    |
| Notifications     | `expo-notifications`                 | Push tokens via `getExpoPushTokenAsync()`   |
| Haptics           | `expo-haptics`                       | `impactAsync`, `notificationAsync`          |
| Tailwind (RN)     | NativeWind v4                        | `className` prop, Tailwind CSS in RN        |

## Common Mistakes

| Mistake                                                  | Correct Pattern                                               |
| -------------------------------------------------------- | ------------------------------------------------------------- |
| Using `react-navigation` directly instead of Expo Router | Expo Router wraps React Navigation with file-based routing    |
| Forgetting `_layout.tsx` in route directories            | Every directory with routes needs a layout file               |
| Using `expo start` for custom native code                | Use `expo start --dev-client` with `expo-dev-client`          |
| Running `eas update` after native dependency changes     | Native changes require `eas build`, OTA is JS-only            |
| Hardcoding platform checks with `if`                     | Use `Platform.select()` or platform-specific file extensions  |
| Not requesting permissions before accessing device APIs  | Always check/request permissions before camera, notifications |
| Using `ScrollView` for long lists                        | Use `FlatList` or `FlashList` for virtualized rendering       |
| Inline styles in render functions                        | Define styles with `StyleSheet.create()` outside component    |
| Missing `keyExtractor` on `FlatList`                     | Always provide `keyExtractor` for stable list rendering       |
| Importing from `react-native` for Expo-provided APIs     | Prefer `expo-*` packages over `react-native` equivalents      |

## Delegation

- **Pattern discovery**: Use `Explore` agent
- **Build/deployment review**: Use `Task` agent
- **Code review**: Delegate to `code-reviewer` agent

> If the `react-patterns` skill is available, delegate React component patterns and hooks to it.
> If the `tanstack-query` skill is available, delegate data fetching and caching to it.
> If the `zustand` skill is available, delegate client-side state management to it.
> If the `vitest-testing` skill is available, delegate unit and component testing patterns to it.
> If the `tailwind` skill is available, delegate Tailwind CSS utility patterns to it (NativeWind uses Tailwind CSS syntax).
> If the `accessibility` skill is available, delegate mobile accessibility patterns to it.

## References

- [Core patterns: StyleSheet, FlatList, Platform-specific code](references/core-patterns.md)
- [Expo Router navigation: stack, tabs, drawer, typed routes](references/expo-router.md)
- [EAS Build, Submit, and Update workflows](references/eas-workflows.md)
- [Dev client and native modules with Expo Modules API](references/native-modules.md)
- [Device APIs: camera, notifications, haptics](references/device-apis.md)
- [NativeWind Tailwind CSS integration](references/nativewind.md)
- [App configuration and environment setup](references/app-configuration.md)
- [Performance optimization patterns](references/performance-patterns.md)

© oakoss · MIT · oakoss/agent-skills

Similar skills

All skills for Mobile →

react-native by other authors comes first.

react-native vercel-labs This skill turns JSON specs into native React Native mobile UIs. Use it when screens need state bindings, conditional visibility, and actions. CX Codex +1 3,300installs react-native jezweb Performance guidelines and architecture patterns for React Native and Expo apps. Helps coding agents handle list virtualization, UI-thread animations, and navigation. CX Codex +1 1,300installs react-native alinaqi Sets project structure, component patterns and testing rules for React Native. Kicks in when the agent touches .tsx files or iOS and Android code. CX Codex +1 575installs react-native gentleman-programming Patterns for React Native mobile development across iOS and Android. Covers typed components, navigation with Expo Router, NativeWind styling, and state management. CX Codex +1 263installs react-native assistant-ui Skill for building mobile AI chat with AI SDK v7 in Expo and React Native via @assistant-ui/react-native. Agent sets up runtime, ThreadPrimitive, ComposerPrimitive, styles and absolute API endpoint. CX Codex +1 1,200installs expo-react-native-development-expert Giuseppe Trisciuoglio expo-react-native-development-expert builds cross-platform mobile apps using Expo SDK 54 and React Native 0.81. Assists with file-based routing, local vector search, and native UI patterns. CX Codex ★ 372repo stars upgrading-react-native callstackincubator upgrading-react-native upgrades React Native apps to newer versions by applying rn-diff-purge template diffs, migrating iOS and Android native config, and resolving CocoaPods and Gradle conflicts. CX Codex +1 14,100installs react-native-brownfield-migration callstackincubator react-native-brownfield-migration guides incremental React Native or Expo adoption in native iOS and Android apps using @callstack/react-native-brownfield. CX Codex +1 5,700installs dt-setup-react-native Dynatrace dt-setup-react-native configures the Dynatrace mobile plugin and Session Replay in React Native or Expo apps. It handles Babel setup, config files, and privacy options. CX Codex +1 1,200installs react-native-patterns spencerpauly The react-native-patterns skill guides an agent building React Native and Expo apps, covering navigation, platform-specific code, styling, lists, and native modules. CX Codex +1 440installs upgrade-react-native react-native-community upgrade-react-native upgrades React Native Community CLI projects to a target version using diffs from the React Native Upgrade Helper. CX Codex +1 1,300installs

From the same set106

The whole set →

Project sponsors

Companies that keep this analytics open