list-performance-images — Claude Code rule for list images
list-performance-images is a Claude Code rule for loading appropriately sized images in lists. It applies when editing interfaces that display image thumbnails.
AGPL-3.0 ★ 88 updated 2026-11-17
.claude/rules/list-performance-images.mdWhat list-performance-images does
The rule directs the agent to request images sized for their display area instead of loading full-resolution originals into lists. A server can return thumbnails, or an image CDN can resize them through URL parameters. For Retina screens, it recommends requesting images at twice their displayed dimensions.
It also names image components with caching and placeholder support, including expo-image and SolitoImage. The rule links oversized images to higher memory use and janky scrolling.
What it helps with
- reduce the size of images loaded in lists
- lower memory use when displaying thumbnails
- avoid scroll jank caused by full-resolution images
Example prompts for the agent
- Update the product list to load thumbnails instead of original images.
- Adjust list image requests for Retina displays.
- Use an image component with caching and placeholders in this list.
How to install list-performance-images
Manually: put the files in place
.claude/rules/list-performance-images.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-images.mdcFrontmatter: description, globs, alwaysApply
Manually: put the files in place
.github/instructions/list-performance-images.instructions.mdThe applyTo field sets which files it applies to
Manually: put the files in place
.devin/rules/list-performance-images.mdManually: put the files in place
.clinerules/list-performance-images.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-images
How do I install list-performance-images in Claude Code?
Add the rule file at .claude/rules/list-performance-images.md.
What does list-performance-images do?
It tells the agent to request images sized for their display area in lists, and gives guidance for Retina screens and image components with caching.
What image size does list-performance-images recommend for Retina screens?
It recommends requesting images at twice their displayed dimensions.