nextjs-app-router

Configure file-system routing with nested layouts, route groups, parallel routes, and error boundaries in Next.js App Router. Use when creating page routes, adding loading/error states, or organizing routes with groups and dynamic segments.

Jump to install

Repository: HoangNguyen0403/agent-skills-standard
Last source activity: July 14, 2026 at 18:20
Detected SKILL.md language: English
Stars: 542
Forks: 159

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/HoangNguyen0403/agent-skills-standard --skill nextjs-app-router

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

4 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

common-best-practices

Enforce SOLID principles, guard-clause style, function size limits, and intention-revealing naming across all languages. Use when refactoring for readability, applying clean-code patterns, reviewing naming conventions, or reducing function complexity.

2026-07-14

common-code-review

Conduct high-quality, persona-driven code reviews. Use when reviewing PRs, critiquing code quality, or analyzing changes for team feedback.

2026-07-14

common-context-optimization

Maximize context window efficiency, reduce latency, and prevent lost-in-middle issues through strategic masking and compaction. Use when token budgets are tight, tool outputs overflow the context, conversations drift from intent, or latency spikes from cache misses.

2026-07-14

View all from this repository

name	nextjs-app-router
description	Configure file-system routing with nested layouts, route groups, parallel routes, and error boundaries in Next.js App Router. Use when creating page routes, adding loading/error states, or organizing routes with groups and dynamic segments.
metadata	{"triggers":{"files":["app//page.tsx","app//layout.tsx","app/**/loading.tsx"],"keywords":["App Router","Layout","Route Group","parallel routes"]}}

Priority: P0 (CRITICAL)

Workflow: Add New Route

Create page — Add app/dashboard/page.tsx as Server Component.
Add layout — Create app/dashboard/layout.tsx returning {children}.
Add loading state — Create app/dashboard/loading.tsx for Suspense boundary.
Add error boundary — Create app/dashboard/error.tsx with 'use client' and reset prop.
Await async APIs — In Next.js 15+, await params, cookies(), headers().

Route Group Example

See implementation examples

Implementation Guidelines

Routing Architecture

Structure: Use app/ directory. Define routes with app/dashboard/layout.tsx returning {children}; shared UI nests inside app/layout.tsx automatically. Handle states with loading.tsx, error.tsx, and not-found.tsx.
Segments: Organize features with Route Groups (brackets (auth)) to excluded from URL path. Use Dynamic Routes (brackets [slug]) and define static paths via generateStaticParams.
Specialized: Use Parallel Routes (@modal) by adding slot to parent layout and providing default.tsx fallback. Use Intercepting Routes ((.)route) for advanced layouts like dashboards.

Data & Functions

Next.js 15+ Async: Always await params: Promise, searchParams, cookies(), and headers().
Security: Use middleware.ts for edge-side authentication and redirection. Ensure all Route Handlers (route.ts) secured with appropriate auth checks.
RSC: Default to React Server Components (RSC). Only use 'use client' at leaf nodes for interactivity (hooks/events).
Error Boundaries: Create app/dashboard/loading.tsx to auto-wrap routes in Suspense boundary. In error.tsx, use 'use client' and provide reset: () => void function.

File Conventions

page.tsx: UI for route.
layout.tsx: Shared UI wrapping children. Persists across navigation.
loading.tsx: Suspense boundary for loading states.
error.tsx: Error boundary (Must Client Component).
route.ts: Server-side API endpoint.

Structure Patterns

Route Groups: Use parenthesis (auth) to organize without affecting URL path.
Private Folders: Use underscore _lib to exclude from routing.
Dynamic Routes: Use brackets [slug] or [...slug] (catch-all).

Best Practices

RSC Boundaries: Ensure props passed to Client Components serializable. See RSC Boundaries & Serialization.
Parallel Routes (@folder): Render multiple pages in same layout. Use default.tsx for fallback.
Intercepting Routes ((..)folder): Load routes within current layout context.
Colocation: Keep component files, styles, and tests inside route folder.
Layouts: Use Root Layout (app/layout.tsx) for <html> and <body> tags.
Self-Hosting Standard

Anti-Patterns

No unawaited async APIs: params, cookies(), headers() Promises in Next.js 15+; always await.
No 'use client' at tree root: Place at leaves; keep layouts and pages as Server Components.
No <html>/<body> in nested layouts: Only app/layout.tsx (root layout) should include them.
No missing error.tsx: Every route segment needs Client Component error boundary.

nextjs-app-router

Source facts

Install options

Review the source files

More from this repository

Priority: P0 (CRITICAL)

Workflow: Add New Route

Route Group Example

Implementation Guidelines

Routing Architecture

Data & Functions

File Conventions

Structure Patterns

Best Practices

Anti-Patterns

More from this repository

Priority: P0 (CRITICAL)

Workflow: Add New Route

Route Group Example

Implementation Guidelines

Routing Architecture

Data & Functions

File Conventions

Structure Patterns

Best Practices

Anti-Patterns