Skip to content

Melvynx/saveit.now / .agents/skills/vercel-react-native-skills

vercel-react-native-skills

Verified

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.

FileKindSize
AGENTS.mdmarkdown72.0 KB
README.mdmarkdown4.9 KB
SKILL.mdskill md4.3 KB
metadata.jsonconfig896 B
rules/_sections.mdmarkdown2.1 KB
rules/_template.mdmarkdown631 B
rules/animation-derived-value.mdmarkdown1.3 KB
rules/animation-gesture-detector-press.mdmarkdown2.5 KB
rules/animation-gpu-properties.mdmarkdown2.0 KB
rules/design-system-compound-components.mdmarkdown1.6 KB
rules/fonts-config-plugin.mdmarkdown1.4 KB
rules/imports-design-system-folder.mdmarkdown1.4 KB
rules/js-hoist-intl.mdmarkdown1.6 KB
rules/list-performance-callbacks.mdmarkdown1.0 KB
rules/list-performance-function-references.mdmarkdown4.0 KB
rules/list-performance-images.mdmarkdown1.4 KB
rules/list-performance-inline-objects.mdmarkdown2.3 KB
rules/list-performance-item-expensive.mdmarkdown2.4 KB
rules/list-performance-item-memo.mdmarkdown2.2 KB
rules/list-performance-item-types.mdmarkdown2.7 KB
rules/list-performance-virtualize.mdmarkdown1.7 KB
rules/monorepo-native-deps-in-app.mdmarkdown1.1 KB
rules/monorepo-single-dependency-versions.mdmarkdown1.3 KB
rules/navigation-native-navigators.mdmarkdown4.8 KB
rules/react-compiler-destructure-functions.mdmarkdown1.2 KB
rules/react-compiler-reanimated-shared-values.mdmarkdown1.2 KB
rules/react-state-dispatcher.mdmarkdown2.2 KB
rules/react-state-fallback.mdmarkdown1.7 KB
rules/react-state-minimize.mdmarkdown1.7 KB
rules/rendering-no-falsy-and.mdmarkdown1.8 KB
rules/rendering-text-in-text-component.mdmarkdown697 B
rules/scroll-position-no-state.mdmarkdown1.9 KB
rules/state-ground-truth.mdmarkdown2.1 KB
rules/ui-expo-image.mdmarkdown1.6 KB
rules/ui-image-gallery.mdmarkdown2.5 KB
rules/ui-measure-views.mdmarkdown2.2 KB
rules/ui-menus.mdmarkdown4.5 KB
rules/ui-native-modals.mdmarkdown1.8 KB
rules/ui-pressable.mdmarkdown1.5 KB
rules/ui-safe-area-scroll.mdmarkdown1.5 KB
rules/ui-scrollview-content-inset.mdmarkdown1.3 KB
rules/ui-styling.mdmarkdown2.2 KB

rules/list-performance-item-expensive.md

View on GitHub
---
title: Keep List Items Lightweight
impact: HIGH
impactDescription: reduces render time for visible items during scroll
tags: lists, performance, virtualization, hooks
---

## Keep List Items Lightweight

List items should be as inexpensive as possible to render. Minimize hooks, avoid
queries, and limit React Context access. Virtualized lists render many items
during scroll—expensive items cause jank.

**Incorrect (heavy list item):**

```tsx
function ProductRow({ id }: { id: string }) {
  // Bad: query inside list item
  const { data: product } = useQuery(['product', id], () => fetchProduct(id))
  // Bad: multiple context accesses
  const theme = useContext(ThemeContext)
  const user = useContext(UserContext)
  const cart = useContext(CartContext)
  // Bad: expensive computation
  const recommendations = useMemo(
    () => computeRecommendations(product),
    [product]
  )

  return <View>{/* ... */}</View>
}
```

**Correct (lightweight list item):**

```tsx
function ProductRow({ name, price, imageUrl }: Props) {
  // Good: receives only primitives, minimal hooks
  return (
    <View>
      <Image source={{ uri: imageUrl }} />
      <Text>{name}</Text>
      <Text>{price}</Text>
    </View>
  )
}
```

**Move data fetching to parent:**

```tsx
// Parent fetches all data once
function ProductList() {
  const { data: products } = useQuery(['products'], fetchProducts)

  return (
    <LegendList
      data={products}
      renderItem={({ item }) => (
        <ProductRow name={item.name} price={item.price} imageUrl={item.image} />
      )}
    />
  )
}
```

**For shared values, use Zustand selectors instead of Context:**

```tsx
// Incorrect: Context causes re-render when any cart value changes
function ProductRow({ id, name }: Props) {
  const { items } = useContext(CartContext)
  const inCart = items.includes(id)
  // ...
}

// Correct: Zustand selector only re-renders when this specific value changes
function ProductRow({ id, name }: Props) {
  // use Set.has (created once at the root) instead of Array.includes()
  const inCart = useCartStore((s) => s.items.has(id))
  // ...
}
```

**Guidelines for list items:**

- No queries or data fetching
- No expensive computations (move to parent or memoize at parent level)
- Prefer Zustand selectors over React Context
- Minimize useState/useEffect hooks
- Pass pre-computed values as props

The goal: list items should be simple rendering functions that take props and
return JSX.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall