Skip to content
React Native Best Practices

React Native Best Practices Skill

Vercel's React Native and Expo best-practices skill: prioritised rules for list performance, Reanimated animation, native navigation, UI patterns, state, rendering, monorepos and configuration, each with code examples.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from vercel-labs/agent-skills.

$ npx skills add vercel-labs/agent-skills --skill vercel-react-native-skills

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

Copy the whole skill folder — SKILL.md and any scripts or references beside it — into ~/.claude/skills/vercel-react-native-skills/, where Claude Code picks it up in every project. Only git is needed.

tmp=$(mktemp -d) && \
  git clone --depth 1 --branch main https://github.com/vercel-labs/agent-skills.git "$tmp" && \
  mkdir -p ~/.claude/skills && \
  cp -R "$tmp"/skills/react-native-skills ~/.claude/skills/vercel-react-native-skills

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/vercel-react-native-skills/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Eight rule categories ranked from critical to low impact
  • FlashList virtualisation and list-item memoisation rules
  • Reanimated, gesture and native navigation guidance
  • expo-image, native menus and modals, safe-area handling
  • React Compiler and monorepo native-dependency rules
  • Each rule with incorrect and correct code examples

React Native Best Practices (published as vercel-react-native-skills) is Vercel's rule set for coding agents building React Native and Expo apps. It loads when an agent builds components, tunes list and scroll performance, implements animations with Reanimated, handles images and media, configures native modules or fonts, or structures a monorepo with native dependencies.

The rules are grouped into eight categories ranked by impact. List performance is critical: virtualise large lists with FlashList, memoise list items, stabilise callbacks, avoid inline style objects, optimise images and use item types for mixed lists. Animation rules keep work on transform and opacity, use useDerivedValue for computed values and prefer Gesture.Tap to Pressable for animated presses. Navigation favours native stack and native tabs over JavaScript navigators.

UI patterns cover expo-image for every image, Galeria for lightboxes, Pressable over TouchableOpacity, safe areas in ScrollViews, contentInset for headers, native context menus and modals, and onLayout instead of measure(). State rules minimise subscriptions and cover React Compiler interactions with destructured functions and Reanimated shared values. Rendering rules catch text outside <Text> and falsy && conditionals; monorepo rules keep native dependencies in the app package with single versions; configuration rules cover font config plugins, design-system imports and hoisting Intl objects.

Each rule lives in its own file with an explanation, an incorrect example, a correct example and references, and a compiled AGENTS.md holds them all in one document. MIT licensed, part of vercel-labs/agent-skills.

SKILL.md

The instructions your agent loads, as published by Vercel.

SKILL.md
name
vercel-react-native-skills
description
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
license
MIT
metadata
author: vercel version: '1.0.0'

React Native Skills

Comprehensive best practices for React Native and Expo applications. Contains
rules across multiple categories covering performance, animations, UI patterns,
and platform-specific optimizations.

When to Apply

Reference these guidelines when:

  • Building React Native or Expo apps
  • Optimizing list and scroll performance
  • Implementing animations with Reanimated
  • Working with images and media
  • Configuring native modules or fonts
  • Structuring monorepo projects with native dependencies
Rule Categories by Priority
PriorityCategoryImpactPrefix
1List PerformanceCRITICALlist-performance-
2AnimationHIGHanimation-
3NavigationHIGHnavigation-
4UI PatternsHIGHui-
5State ManagementMEDIUMreact-state-
6RenderingMEDIUMrendering-
7MonorepoMEDIUMmonorepo-
8ConfigurationLOWfonts-, imports-
Quick Reference
1. List Performance (CRITICAL)
  • list-performance-virtualize - Use FlashList for large lists
  • list-performance-item-memo - Memoize list item components
  • list-performance-callbacks - Stabilize callback references
  • list-performance-inline-objects - Avoid inline style objects
  • list-performance-function-references - Extract functions outside render
  • list-performance-images - Optimize images in lists
  • list-performance-item-expensive - Move expensive work outside items
  • list-performance-item-types - Use item types for heterogeneous lists
2. Animation (HIGH)
  • animation-gpu-properties - Animate only transform and opacity
  • animation-derived-value - Use useDerivedValue for computed animations
  • animation-gesture-detector-press - Use Gesture.Tap instead of Pressable
3. Navigation (HIGH)
  • navigation-native-navigators - Use native stack and native tabs over JS navigators
4. UI Patterns (HIGH)
  • ui-expo-image - Use expo-image for all images
  • ui-image-gallery - Use Galeria for image lightboxes
  • ui-pressable - Use Pressable over TouchableOpacity
  • ui-safe-area-scroll - Handle safe areas in ScrollViews
  • ui-scrollview-content-inset - Use contentInset for headers
  • ui-menus - Use native context menus
  • ui-native-modals - Use native modals when possible
  • ui-measure-views - Use onLayout, not measure()
  • ui-styling - Use StyleSheet.create or Nativewind
5. State Management (MEDIUM)
  • react-state-minimize - Minimize state subscriptions
  • react-state-dispatcher - Use dispatcher pattern for callbacks
  • react-state-fallback - Show fallback on first render
  • react-compiler-destructure-functions - Destructure for React Compiler
  • react-compiler-reanimated-shared-values - Handle shared values with compiler
6. Rendering (MEDIUM)
  • rendering-text-in-text-component - Wrap text in Text components
  • rendering-no-falsy-and - Avoid falsy && for conditional rendering
7. Monorepo (MEDIUM)
  • monorepo-native-deps-in-app - Keep native dependencies in app package
  • monorepo-single-dependency-versions - Use single versions across packages
8. Configuration (LOW)
  • fonts-config-plugin - Use config plugins for custom fonts
  • imports-design-system-folder - Organize design system imports
  • js-hoist-intl - Hoist Intl object creation
How to Use

Read individual rule files for detailed explanations and code examples:

rules/list-performance-virtualize.md
rules/animation-gpu-properties.md

Each rule file contains:

  • Brief explanation of why it matters
  • Incorrect code example with explanation
  • Correct code example with explanation
  • Additional context and references
Full Compiled Document

For the complete guide with all rules expanded: AGENTS.md

Install
Featured

Expo's official skill for building native-feeling screens: Apple HIG styling, semantic colors, SF Symbols, native controls, Reanimated, blur and liquid glass.

Browse all skills →