What problem does it solve?
Next.js codebases often drift into patterns that break React Server Components boundaries, metadata rules, routing conventions, or performance expectations, causing bugs, hydration issues, and inefficient builds.
Core Features & Use Cases
- App Router file conventions: Guides correct placement and usage of
page.tsx, layout.tsx, route.ts, and related special files.
- RSC boundary safety: Detects invalid async client components and non-serializable props crossing Server → Client.
- Modern Next.js async and runtime correctness: Covers async
params/searchParams, cookies()/headers(), and when to prefer Node.js vs Edge runtime.
- Operational guardrails: Standardizes directives (
use client/use server/use cache), route handlers vs server actions, error handling, Suspense requirements for CSR bailout, and hydration error causes.
- SEO, performance, and assets: Implements metadata and OG image best practices, plus image/font optimization and bundling safeguards.
Quick Start
Apply the next-best-practices skill to review your Next.js App Router changes and fix any RSC boundary, async API usage, metadata, and route handler mistakes.