---

name: nextjs-advanced-routing

IMPORTANT: Keep description on ONE line for Claude Code compatibility

prettier-ignore

description: Advanced Next.js routing: Route Handlers (API routes), Server Actions ('use server'), Parallel Routes (@slot), Intercepting Routes ((.)), Error Boundaries, Draft Mode, Suspense streaming. allowed-tools: Read, Write, Edit, Glob, Grep, Bash

Next.js Advanced Routing

Quick Start

Route Handlers: app/api/*/route.ts with GET/POST/PUT/DELETE exports Server Actions: 'use server' directive, form actions return void (or use useActionState) Parallel Routes: @slot/ folders, layout receives slot props Intercepting Routes: (.) for same-level modal interception

Copy// Route Handler
export async function GET() {
  return Response.json({ message: 'Hello' });
}

// Server Action (file-level)
'use server';
export async function createPost(formData: FormData) {
  revalidatePath('/posts');
  // No return - void for form actions
}

Reference Files

• route-handlers.md - API routes, HTTP methods, cookies, headers, CORS, streaming
• server-actions.md - Server Actions patterns, form handling, cookies, revalidation, ⚠️ return type rules
• parallel-intercepting-routes.md - Parallel/Intercepting routes, modal patterns
• error-boundaries.md - Error handling, not-found, global-error
• draft-mode.md - CMS draft preview mode
• streaming-suspense.md - Progressive rendering with Suspense

Notes

• Form actions MUST return void (or use useActionState for data return)
• Scope parallel routes to feature level, not root, unless app-wide
• Last verified: 2025-01-11