Next.js 16 Skill Index

Quick Reference

Next.js 16 Breaking Changes (from 15)

Migration Command

# Migrate middleware.ts to proxy.ts
npx @next/codemod@canary middleware-to-proxy

# Upgrade to Next.js 16
npx @next/codemod@latest upgrade

next.config.ts (Next.js 16)

import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  cacheComponents: true,    // replaces experimental.ppr + dynamicIO
  reactCompiler: true,      // no longer experimental
  // turbopack is default, no config needed
}

export default nextConfig

Key Conventions

• Server Components are the default -- add 'use client' only when needed
• Use "use cache" at top of file or function for caching
• Use proxy.ts for request-level middleware (Node.js runtime)
• Await params and searchParams in all page/layout components
• Provide default.tsx for every parallel route slot
• Use Zod for all input validation in server actions and API routes
• Handle errors with try/catch, never silent returns