vercel-react-native-skills
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
- 最近更新
- 2026-09-14
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- vercel-react-native-skills
- license
- MIT
- metadata
- { "author": "vercel", "version": "1.0.0" }
- 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.
02 资源文件 41
- 参考文档AGENTS.md72.2 KB
- 参考文档metadata.json896 B
- 参考文档README.md4.9 KB
- 参考文档rules/_sections.md2.2 KB
- 参考文档rules/_template.md633 B
- 参考文档rules/animation-derived-value.md1.3 KB
- 参考文档rules/animation-gesture-detector-press.md2.5 KB
- 参考文档rules/animation-gpu-properties.md2.0 KB
- 参考文档rules/design-system-compound-components.md1.6 KB
- 参考文档rules/fonts-config-plugin.md1.4 KB
- 参考文档rules/imports-design-system-folder.md1.4 KB
- 参考文档rules/js-hoist-intl.md1.6 KB
- 参考文档rules/list-performance-callbacks.md1.0 KB
- 参考文档rules/list-performance-function-references.md4.1 KB
- 参考文档rules/list-performance-images.md1.4 KB
- 参考文档rules/list-performance-inline-objects.md2.3 KB
- 参考文档rules/list-performance-item-expensive.md2.4 KB
- 参考文档rules/list-performance-item-memo.md2.2 KB
- 参考文档rules/list-performance-item-types.md2.7 KB
- 参考文档rules/list-performance-virtualize.md1.7 KB
- 参考文档rules/monorepo-native-deps-in-app.md1.1 KB
- 参考文档rules/monorepo-single-dependency-versions.md1.3 KB
- 参考文档rules/navigation-native-navigators.md4.8 KB
- 参考文档rules/react-compiler-destructure-functions.md1.3 KB
- 参考文档rules/react-compiler-reanimated-shared-values.md1.2 KB
- 参考文档rules/react-state-dispatcher.md2.2 KB
- 参考文档rules/react-state-fallback.md1.7 KB
- 参考文档rules/react-state-minimize.md1.7 KB
- 参考文档rules/rendering-no-falsy-and.md1.8 KB
- 参考文档rules/rendering-text-in-text-component.md701 B
- 参考文档rules/scroll-position-no-state.md1.9 KB
- 参考文档rules/state-ground-truth.md2.1 KB
- 参考文档rules/ui-expo-image.md1.6 KB
- 参考文档rules/ui-image-gallery.md2.5 KB
- 参考文档rules/ui-measure-views.md2.2 KB
- 参考文档rules/ui-menus.md4.5 KB
- 参考文档rules/ui-native-modals.md1.8 KB
- 参考文档rules/ui-pressable.md1.5 KB
- 参考文档rules/ui-safe-area-scroll.md1.5 KB
- 参考文档rules/ui-scrollview-content-inset.md1.3 KB
- 参考文档rules/ui-styling.md2.2 KB
03 SKILL.md 正文
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
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | List Performance | CRITICAL | list-performance- |
| 2 | Animation | HIGH | animation- |
| 3 | Navigation | HIGH | navigation- |
| 4 | UI Patterns | HIGH | ui- |
| 5 | State Management | MEDIUM | react-state- |
| 6 | Rendering | MEDIUM | rendering- |
| 7 | Monorepo | MEDIUM | monorepo- |
| 8 | Configuration | LOW | fonts-, imports- |
Quick Reference
1. List Performance (CRITICAL)
list-performance-virtualize- Use FlashList for large listslist-performance-item-memo- Memoize list item componentslist-performance-callbacks- Stabilize callback referenceslist-performance-inline-objects- Avoid inline style objectslist-performance-function-references- Extract functions outside renderlist-performance-images- Optimize images in listslist-performance-item-expensive- Move expensive work outside itemslist-performance-item-types- Use item types for heterogeneous lists
2. Animation (HIGH)
animation-gpu-properties- Animate only transform and opacityanimation-derived-value- Use useDerivedValue for computed animationsanimation-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 imagesui-image-gallery- Use Galeria for image lightboxesui-pressable- Use Pressable over TouchableOpacityui-safe-area-scroll- Handle safe areas in ScrollViewsui-scrollview-content-inset- Use contentInset for headersui-menus- Use native context menusui-native-modals- Use native modals when possibleui-measure-views- Use onLayout, not measure()ui-styling- Use StyleSheet.create or Nativewind
5. State Management (MEDIUM)
react-state-minimize- Minimize state subscriptionsreact-state-dispatcher- Use dispatcher pattern for callbacksreact-state-fallback- Show fallback on first renderreact-compiler-destructure-functions- Destructure for React Compilerreact-compiler-reanimated-shared-values- Handle shared values with compiler
6. Rendering (MEDIUM)
rendering-text-in-text-component- Wrap text in Text componentsrendering-no-falsy-and- Avoid falsy && for conditional rendering
7. Monorepo (MEDIUM)
monorepo-native-deps-in-app- Keep native dependencies in app packagemonorepo-single-dependency-versions- Use single versions across packages
8. Configuration (LOW)
fonts-config-plugin- Use config plugins for custom fontsimports-design-system-folder- Organize design system importsjs-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
04 同仓库更多 Skills
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
vercel-composition-patterns
React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.
review-logging-patterns
Review code for logging patterns and suggest evlog adoption. Guides setup on Nuxt, Next.js, SvelteKit, Nitro, TanStack Start, React Router, NestJS, Express, Hono, Fastify, Elysia, oRPC, Cloudflare Workers, and standalone TypeScript. Detects console.log spam, unstructured errors, and missing context. Covers wide events, structured errors, drain adapters (Axiom, OTLP, HyperDX, PostHog, Sentry, Better Stack, Datadog), sampling, enrichers, and AI SDK integration (token usage, tool calls, streaming metrics, telemetry integration, cost estimation, embedding metadata).
native-data-fetching
Use when implementing or debugging ANY network request, API call, or data fetching. Covers fetch API, React Query, SWR, error handling, caching, offline support, and Expo Router data loaders (`useLoaderData`).
heroui-native
HeroUI Native component library for React Native (Tailwind v4 via Uniwind). Use when building mobile UIs with HeroUI Native — creating Buttons, Cards, TextFields, Dialogs; installing heroui-native; configuring dark/light themes; or fetching component docs. Keywords: HeroUI Native, heroui-native, React Native UI, Uniwind, mobile components.
expo-tailwind-setup
Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal styling