Vercel React Best Practices

This is Vercel's internal performance playbook turned into actionable code guidance. It runs 69 specific checks across React and Next.js codebases, catching things like barrel import performance hits, async waterfall patterns, and unnecessary re-renders. The rules are prioritized by actual impact, so it tackles bundle size killers and server-side bottlenecks before micro-optimizations. Each rule includes before/after code examples showing exactly what to fix. If you're shipping React apps at scale or just want to stop guessing about performance patterns, this codifies what the Vercel team actually follows internally.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 524
skills.sh installs: 885.1K
GitHub stars: 33.8K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add vercel-labs/agent-skills --skill vercel-react-best-practices --agent claude-code

Installs into .claude/skills of the current project.

Files

Vercel React Best Practices

Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Contains 70 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.

When to Apply

Reference these guidelines when:

Writing new React components or Next.js pages
Implementing data fetching (client or server-side)
Reviewing code for performance issues
Refactoring existing React/Next.js code
Optimizing bundle size or load times

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Eliminating Waterfalls	CRITICAL	`async-`
2	Bundle Size Optimization	CRITICAL	`bundle-`
3	Server-Side Performance	HIGH	`server-`
4	Client-Side Data Fetching	MEDIUM-HIGH	`client-`
5	Re-render Optimization	MEDIUM	`rerender-`
6	Rendering Performance	MEDIUM	`rendering-`
7	JavaScript Performance	LOW-MEDIUM	`js-`
8	Advanced Patterns	LOW	`advanced-`