What problem does it solve?
Consolidates Next.js conventions and checks to prevent common routing, rendering, and performance mistakes that cause runtime errors, hydration mismatches, and poor SEO.
Core Features & Use Cases
- File Conventions & Routing: Guidance for project structure, dynamic/catch-all segments, route groups, and parallel/intercepting routes.
- RSC Boundaries & Async Patterns: Detect invalid async client components, non-serializable props, and correct usage of async params, cookies, and headers.
- Metadata, Images & Bundling: Best practices for the Metadata API, OG image generation, next/image usage, font optimization, and avoiding server-incompatible packages.
- Error Handling & Debugging: Patterns for error.tsx/global-error, navigation gotchas, hydration fixes, and MCP-assisted debug tips.
- Use Case: Run during PR reviews, migrations, or architecture audits to flag RSC violations, route handler conflicts, and bundling/runtime issues and get actionable remediation steps.
Quick Start
Run a targeted Next.js code review against the next-best-practices checklist to flag RSC boundary issues, async API misuse, routing conflicts, metadata problems, and bundling pitfalls.