What problem does it solve?
Developers often struggle to correctly structure and organize Next.js app directory routes, leading to broken navigation, inconsistent layouts, and hard-to-maintain code. This Skill provides clear, actionable conventions so teams can build predictable route hierarchies and UI boundaries.
Core Features & Use Cases
- File & Folder Conventions: Explains page, layout, loading, error, not-found, template, and default file roles and placement.
- Routing Patterns: Covers dynamic segments, catch-all, optional catch-all, route groups, private folders, parallel routes, and intercepting routes.
- UX States & Metadata: Advises on loading and error boundaries, not-found handling, static and dynamic metadata, and layout composition for nested routes.
- Real-world Use Case: Use to add a blog with dynamic slugs, nested dashboard layouts, and modal intercepting routes while preserving layout state.
Quick Start
Use the app-router skill to add a new app/blog/[slug]/page that implements dynamic routing, fetches the post, and returns notFound when missing.