vercel-react-best-practices

Review React and Next.js code for performance issues like waterfalls and bundle bloat.

Updated Nov 1, 2025
One-click install
npx skills add https://github.com/mhfed/portfolio-2025 --skill vercel-react-best-practices-mhfed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-react-best-practices
Source: https://github.com/mhfed/portfolio-2025/tree/main/.agents/skills/vercel-react-best-practices
Command: npx skills add https://github.com/mhfed/portfolio-2025 --skill vercel-react-best-practices-mhfed

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams write and review React and Next.js code with a strong performance mindset, reducing waterfalls, unnecessary re-renders, oversized bundles, and hydration issues that slow down modern web apps.

Core Features & Use Cases

  • Performance Refactoring Guidance: Improves async flow, server rendering, component rendering, and bundle loading patterns.
  • Next.js-Specific Best Practices: Covers App Router behavior, server actions, suspense boundaries, caching, and route-handler optimization.
  • Use Case: A developer can use this Skill to review a slow product page, identify sequential fetches and heavy imports, and rewrite the code to load faster with fewer client-side costs.

Quick Start

Ask for a review of your React or Next.js component and request concrete performance improvements based on these best practices.

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 optimize React and Next.js component performance and reduce bundle size?

To optimize React and Next.js performance, you must reduce waterfalls, bundle bloat, re-renders, and hydration issues. This involves applying async parallelism, splitting heavy imports, using memoization, and ensuring SSR-safe client behavior for leaner apps.

What is the best way to fix sequential data fetching waterfalls in Next.js App Router?

Fixing data fetching waterfalls in Next.js requires restructuring sequential fetches into parallel asynchronous operations. You should also leverage App Router caching, suspense boundaries, and server actions to optimize rendering and reduce client-side loading costs.

Why does my Next.js page suffer from hydration issues and unnecessary re-renders?

Hydration issues and unnecessary re-renders often occur due to non-SSR-safe client behavior and missing memoization. Reviewing component authoring patterns to enforce async parallelism and proper suspense boundaries resolves these performance bottlenecks.

Does this approach work for refactoring slow product pages with heavy imports?

Yes, performance refactoring is designed for slow product pages with heavy imports. It identifies sequential fetches and oversized bundles, rewriting the code through import splitting and server rendering to load faster with fewer client-side costs.

How do I review and improve server actions and route-handler optimization in Next.js?

Reviewing server actions and route handlers requires analyzing Next.js App Router behavior and caching strategies. Apply Vercel engineering rules to refactor async flows, enforce parallelism, and optimize suspense boundaries for better server rendering performance.

What are the limitations when applying memoization and import splitting for React performance?

When applying memoization and import splitting, limitations arise if components lack SSR-safe client behavior or violate async parallelism rules. Improper suspense boundary placement during page refactoring can also hinder hydration and negate bundle size reductions.