list-performance-virtualize — Claude Code rule for lists
list-performance-virtualize is a Claude Code rule that recommends virtualized lists for scrollable content. It applies while building list-based screens.
AGPL-3.0 ★ 88 updated 2026-11-17
.claude/rules/list-performance-virtualize.mdWhat list-performance-virtualize does
The rule favors a list virtualizer over placing mapped children inside ScrollView. Its examples use LegendList and FlashList, which mount items as they enter the visible area rather than creating every row at once.
The recommendation also covers short lists. The rule names feeds, profiles, settings, and search results as places where it applies, and its examples use React components. For Claude Code, place the rule at .claude/rules/list-performance-virtualize.md.
What it helps with
- replace a mapped
ScrollViewlist with virtualization - limit how many list items mount at once
- virtualize a feed or search results
- choose between
LegendListandFlashList
Example prompts for the agent
- Replace the mapped children in
ScrollViewwith a list virtualizer. - Build this feed with
LegendListandItemCard. - Rewrite the search results using
FlashList.
How to install list-performance-virtualize
Manually: put the files in place
.claude/rules/list-performance-virtualize.mdThe paths frontmatter field limits the files
AGENTS.md
Codex reads AGENTS.md: paste the rule text there
Manually: put the files in place
.cursor/rules/list-performance-virtualize.mdcFrontmatter: description, globs, alwaysApply
Manually: put the files in place
.github/instructions/list-performance-virtualize.instructions.mdThe applyTo field sets which files it applies to
Manually: put the files in place
.devin/rules/list-performance-virtualize.mdManually: put the files in place
.clinerules/list-performance-virtualize.mdStep by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use
Questions about list-performance-virtualize
How do I install list-performance-virtualize in Claude Code?
Add the rule file at .claude/rules/list-performance-virtualize.md.
What does list-performance-virtualize do?
It recommends virtualizing scrollable lists so items are mounted as they become visible, rather than creating the whole list upfront. The examples use LegendList and FlashList.
Which virtualizers does list-performance-virtualize show?
Its examples present LegendList and FlashList as alternatives to a mapped ScrollView.