vercel-react-best-practices

Applies Vercel performance optimization rules when writing, reviewing, or refactoring React and Next.js code.

Updated May 22, 2026
One-click install
npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill vercel-react-best-practices-viniciuscs84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-react-best-practices
Source: https://github.com/viniciuscs84/sdd-toolkit/tree/main/skills/vercel-react-best-practices
Command: npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill vercel-react-best-practices-viniciuscs84

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? React and Next.js codebases often suffer from performance issues like data-fetching waterfalls, bloated bundles, unnecessary re-renders, and server-side bottlenecks. This Skill provides a structured, impact-prioritized rule set from Vercel Engineering so AI agents and developers consistently apply proven optimization patterns instead of guessing. ## Core Features & Use Cases - 70 Prioritized Rules Across 8 Categories: Covers eliminating waterfalls, bundle size optimization, server-side performance, client-side data fetching, re-render optimization, rendering performance, JavaScript performance, and advanced patterns, each tagged with an impact level from CRITICAL to LOW. - Incorrect vs. Correct Code Examples: Every rule includes concrete TypeScript/TSX examples showing the anti-pattern and the optimized implementation, plus impact metrics like "2-10x improvement" or "200-800ms import cost". - Use Case: When refactoring a Next.js page that sequentially awaits user, posts, and comments fetches, the Skill directs you to parallelize them with Promise.all(), cutting three network round trips down to one. ## Quick Start Ask the AI to review your React component or Next.js page for performance issues using the Vercel React best practices rules.

Frequently Asked Questions about vercel-react-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I eliminate data fetching waterfalls in Next.js?

Start independent async operations immediately and await them together with Promise.all() instead of awaiting sequentially. For partial dependencies, use the better-all library or chain promises so each task starts at the earliest possible moment.

How to reduce bundle size from barrel file imports in React?

Import directly from source files instead of barrel entry points that re-export thousands of modules. In Next.js 13.5+, enable optimizePackageImports in next.config.js to automatically transform imports for libraries like lucide-react and @mui/material.

Does this guide work with React Server Components?

Yes, it includes server-side rules specific to RSC, such as minimizing serialization at RSC boundaries, avoiding duplicate serialization in props, using React.cache() for per-request deduplication, and avoiding shared module state for request data.

When should I use Suspense boundaries in Next.js pages?

Use Suspense when only part of the layout needs async data, so the wrapper UI renders immediately while data streams in. Avoid it for SEO-critical above-the-fold content or when layout shift from loading states hurts the user experience.

Why do Server Actions need authentication checks inside the function?

Server Actions are exposed as public endpoints just like API routes, so middleware or layout guards alone are insufficient. Always verify authentication and authorization inside each action, and validate inputs with a schema like zod before performing mutations.