All skills
vercel-labs avatar

/vercel-react-native-skills

@f2d73db
by Vercel Labsvercel-labs/openreview1.7k stars
118

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.

Use this Skill: https://skilld.dev/gh/vercel-labs/openreview/vercel-react-native-skills

This session only. Nothing lands on disk.

rulesreact-state-fallback.md

≈434 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Use fallback state instead of initialState

Use undefined as initial state and nullish coalescing (??) to fall back to parent or server values. State represents user intent only—undefined means "user hasn't chosen yet." This enables reactive fallbacks that update when the source changes, not just on initial render.

Incorrect (syncs state, loses reactivity):

type Props = { fallbackEnabled: boolean }

function Toggle({ fallbackEnabled }: Props) {
  const [enabled, setEnabled] = useState(defaultEnabled)
  // If fallbackEnabled changes, state is stale
  // State mixes user intent with default value

  return <Switch value={enabled} onValueChange={setEnabled} />
}

Correct (state is user intent, reactive fallback):

type Props = { fallbackEnabled: boolean }

function Toggle({ fallbackEnabled }: Props) {
  const [_enabled, setEnabled] = useState<boolean | undefined>(undefined)
  const enabled = _enabled ?? defaultEnabled
  // undefined = user hasn't touched it, falls back to prop
  // If defaultEnabled changes, component reflects it
  // Once user interacts, their choice persists

  return <Switch value={enabled} onValueChange={setEnabled} />
}

With server data:

function ProfileForm({ data }: { data: User }) {
  const [_theme, setTheme] = useState<string | undefined>(undefined)
  const theme = _theme ?? data.theme
  // Shows server value until user overrides
  // Server refetch updates the fallback automatically

  return <ThemePicker value={theme} onChange={setTheme} />
}

Source: SKILL.md on GitHub

No alerts17d4 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    This skill provides a comprehensive set of React Native and Expo best practices optimized for AI agents and LLMs. It focuses on performance optimization, UI patterns, and proper state management within mobile applications. The skill is entirely composed of documentation and guidelines without any executable scripts or hidden network operations, making it safe for use.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

  • Runlayer6mo

    39 files scanned · No issues

Signed by skilld at f2d73db. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 7 months ago
metadata
{
  "author": "vercel",
  "version": "1.0.0"
}
  • Performance
  • react-native
  • expo
  • animations
  • reanimated
  • flashlist
  • mobile
  • native-modules
  • monorepo

README badge

README badge for vercel-labs/openreview/vercel-react-native-skills

Provides React Native and Expo best practices organized by priority, covering list performance, animations, navigation, UI patterns, and native module configuration. Use when building or optimizing React Native components, implementing Reanimated animations, or configuring native dependencies in Expo projects.

Generated from the current SKILL.md.

Does this skill cover both React Native and Expo?
Yes. The skill provides best practices for React Native and Expo applications, including Expo-specific patterns like expo-image and config plugins.
What animation library does this skill assume?
Reanimated. The skill includes rules for animating with Reanimated, such as using useDerivedValue and limiting animations to transform and opacity properties.
Does this skill address monorepo setups?
Yes. It includes rules for structuring monorepo projects with native dependencies, such as keeping native dependencies in the app package and maintaining single dependency versions across packages.
What is the priority focus of this skill?
List performance is marked as critical priority, covering virtualization with FlashList, memoization, and image optimization. Animation and navigation are high priority.

Generated from the current SKILL.md. These answers refresh after source changes.