What problem does it solve?
Provide a concise, opinionated reference that prevents common Next.js mistakes and architectural anti-patterns, helping teams maintain correct RSC boundaries, consistent file conventions, and reliable data and metadata patterns across an App Router codebase.
Core Features & Use Cases
- File Conventions & Routing: Guidance on project structure, dynamic and catch-all segments, parallel and intercepting routes, and middleware → proxy migration.
- RSC Boundaries & Async Patterns: Rules to detect async client components, non-serializable props, server action usage, and new async request APIs.
- Data, Metadata & Runtime Practices: Patterns for Server Components, Server Actions, Route Handlers, generateMetadata/OG images, image/font optimization, bundling pitfalls, and self-hosting considerations.
- Error Handling & Debugging: Prescriptions for error.tsx/global-error, navigation gotchas, hydration fixes, MCP debugging, and build/debug tricks.
Quick Start
Review my Next.js app and list file-convention violations, invalid RSC boundaries, async API misuses, metadata and OG image issues, image/font mistakes, bundling problems, and recommended fixes.