vercel-react-best-practices

Applies React and Next.js performance optimization rules during code writing, review, and refactoring.

Updated May 28, 2026
One-click install
npx skills add https://github.com/qbstabletampa-creator/firmware-foundation-studios --skill vercel-react-best-practices-qbstabletampa-creator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vercel-react-best-practices
Source: https://github.com/qbstabletampa-creator/firmware-foundation-studios/tree/main/archive/apps/manna-catch/.agents/skills/react-best-practices
Command: npx skills add https://github.com/qbstabletampa-creator/firmware-foundation-studios --skill vercel-react-best-practices-qbstabletampa-creator

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 async waterfalls, bloated bundles, unnecessary re-renders, and inefficient data fetching. This Skill provides a structured, impact-prioritized rule set from Vercel Engineering so AI agents and developers consistently apply proven optimization patterns instead of discovering them ad hoc. ## 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 multiple fetches, apply the async rules to parallelize independent operations with Promise.all() and add strategic Suspense boundaries so the layout renders immediately while data streams in. ## Quick Start Ask the AI to review your React component or Next.js page against the Vercel React best practices rules and suggest performance improvements.

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 async waterfalls in Next.js API routes?▼

Start independent operations immediately without awaiting them, then await the promises later. Use Promise.all() for fully independent fetches, or the better-all library for operations with partial dependencies, achieving 2-10x improvement.

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

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

Does this guide cover React Server Components performance?▼

Yes, the server-side performance section covers RSC-specific issues including minimizing serialization at RSC boundaries, avoiding duplicate serialization in props, per-request deduplication with React.cache(), and avoiding shared module state for request data.

When should I not use Suspense boundaries for data fetching?▼

Avoid Suspense when critical data drives layout decisions, for SEO-critical above-the-fold content, for small fast queries where overhead is not worth it, or when you want to prevent layout shift between loading and content states.

Why do Server Actions need authentication checks inside the function?▼

Server Actions are exposed as public endpoints just like API routes and can be invoked directly. Middleware or layout guards alone are insufficient, so each action must verify authentication and authorization internally before performing mutations.