Documents the critical v15→v16 breaking changes: proxy.ts replacing middleware.ts, Turbopack-only builds, use cache replacing Partial Prerendering, required React 19, and async params/searchParams. This skill covers core framework APIs only — for assembling a full production stack (Prisma, Better Auth, shadcn/ui, Zustand together) use nextjs-stack instead; for a pure React SPA without next.config.* use the react-expert skills instead.
Next.js 16 Expert
Production-ready React framework with Server Components, streaming, and Turbopack.
Agent Workflow (MANDATORY)
Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:
- fuse-ai-pilot:explore-codebase - Analyze existing routes, components, and patterns
- fuse-ai-pilot:research-expert - Verify latest Next.js 16 docs via Context7/Exa
- mcp__context7__query-docs - Check breaking changes v15→v16
After implementation, run fuse-ai-pilot:sniper for validation.
Overview
When to Use
- Building new React applications with server-first architecture
- Need Server Components for optimal performance and SEO
- Implementing streaming and progressive rendering
- Migrating from Next.js 14/15 to version 16
- Using proxy.ts for route protection (replaces middleware)
- Leveraging Turbopack for faster development builds
Why Next.js 16
| Feature |
Benefit |
| Turbopack default |
2-5x faster builds, 10x faster HMR, Webpack deprecated |
| Cache Components |
Explicit caching with use cache directive |
| proxy.ts |
Full Node.js runtime, replaces Edge middleware |
| React Compiler |
Automatic memoization, no manual useMemo/useCallback |
| React 19 |
View Transitions, useEffectEvent, Activity component |
| App Router |
Nested layouts, parallel routes, intercepting routes |
Breaking Changes from v15
Critical Migration Points
- proxy.ts replaces middleware.ts - Full Node.js runtime, not Edge
- Turbopack ONLY - Webpack completely deprecated and removed
use cache directive - Replaces Partial Prerendering (PPR)
- React 19 required - New hooks and View Transitions API
- Async params/searchParams - Must await dynamic route params
SOLID Architecture
Module-Based Structure
Pages are thin entry points importing from feature modules:
app/page.tsx → imports from modules/public/home/
app/dashboard/page.tsx → imports from modules/auth/dashboard/
modules/cores/ → Shared services, utilities, configurations
File Conventions
- page.tsx - Route UI component
- layout.tsx - Shared UI wrapper
- loading.tsx - Suspense loading state
- error.tsx - Error boundary
- not-found.tsx - 404 handling
Core Concepts
Server Components (Default)
All components are Server Components by default. Use 'use client' directive only when needed for interactivity, hooks, or browser APIs.
Caching Strategy
use cache - Mark async functions for caching
cacheTag() - Tag cached data for targeted revalidation
cacheLife() - Control cache duration (stale, revalidate, expire)
revalidateTag() - Invalidate cached data on-demand
Data Fetching
Server Components fetch data directly. Use fetch() with native caching or database queries. No need for getServerSideProps or getStaticProps.
Reference Guide
| Need |
Reference |
| Initial setup |
installation.md, project-structure.md |
| Migration v15→v16 |
upgrade.md, middleware-migration.md |
| Routing |
app-router.md, routing-advanced.md |
| Caching |
caching.md, cache-components.md |
| Server Components |
server-components.md, directives.md |
| React 19 features |
react-19.md, react-compiler.md |
| Route protection |
proxy.md, security.md |
| SEO/Metadata |
metadata.md, metadata-files.md |
| Forms/Actions |
forms.md, data-fetching.md |
| Deployment |
deployment.md, environment.md |
Best Practices
- Server Components first - Only add
'use client' when necessary
- Colocate data fetching - Fetch data where it's used
- Streaming with Suspense - Wrap slow components in Suspense
- proxy.ts over middleware - Full Node.js runtime for auth
- Cache explicitly - Use
use cache for expensive operations
- Parallel routes - Load independent UI sections simultaneously
Performance
Build Optimization
- Turbopack - Incremental compilation, instant HMR
- React Compiler - Automatic memoization
- Tree shaking - Unused code elimination
- Code splitting - Automatic route-based splitting
Runtime Optimization
- Streaming - Progressive HTML rendering
- Partial hydration - Only hydrate interactive components
- Image optimization - Automatic WebP/AVIF conversion
- Font optimization - Zero layout shift with next/font
1---2name: nextjs-163description: Use when building Next.js 16 apps — Turbopack, App Router, Cache Components, proxy.ts, v15 migration. Not for stack scaffolding (nextjs-stack) or React SPA (react-expert).4versions:5 nextjs: 166 react: 197user-invocable: true8references: references/installation.md, references/upgrade.md, references/project-structure.md, references/typescript.md, references/styling.md, references/app-router.md, references/routing-advanced.md, references/navigation.md, references/route-segment-config.md, references/pages-router.md, references/server-components.md, references/directives.md, references/react-19.md, references/rendering.md, references/streaming.md, references/runtime.md, references/data-fetching.md, references/forms.md, references/static-generation.md, references/cookies-headers.md, references/caching.md, references/cache-components.md, references/turbopack.md, references/react-compiler.md, references/dynamic-imports.md, references/loading-patterns.md, references/error-handling.md, references/proxy.md, references/middleware-migration.md, references/api-routes.md, references/security.md, references/metadata.md, references/metadata-files.md, references/images.md, references/fonts.md, references/scripts.md, references/third-party.md, references/analytics.md, references/instrumentation.md, references/devtools-mcp.md, references/environment.md, references/deployment.md, references/testing.md, references/config-advanced.md9related-skills: nextjs-i18n, better-auth, tailwindcss-core, solid-nextjs, nextjs-stack, nextjs-server-components, nextjs-tanstack-query10metadata:11 source: https://skillmd.com/skills/fusengine/nextjs-1612---1314<objective>15Covers Next.js 16 core framework mechanics: Turbopack (default bundler, Webpack fully removed), the App Router (nested layouts, parallel/intercepting routes, file conventions like page.tsx/layout.tsx/loading.tsx/error.tsx/not-found.tsx), Cache Components (`use cache`, `cacheTag()`, `cacheLife()`, `revalidateTag()`), `proxy.ts` (full Node.js runtime, replaces Edge middleware), and React 19 integration (View Transitions, new hooks).1617Documents the critical v15→v16 breaking changes: proxy.ts replacing middleware.ts, Turbopack-only builds, `use cache` replacing Partial Prerendering, required React 19, and async `params`/`searchParams`. This skill covers core framework APIs only — for assembling a full production stack (Prisma, Better Auth, shadcn/ui, Zustand together) use nextjs-stack instead; for a pure React SPA without `next.config.*` use the react-expert skills instead.18</objective>1920# Next.js 16 Expert2122Production-ready React framework with Server Components, streaming, and Turbopack.2324## Agent Workflow (MANDATORY)2526Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:27281. **fuse-ai-pilot:explore-codebase** - Analyze existing routes, components, and patterns292. **fuse-ai-pilot:research-expert** - Verify latest Next.js 16 docs via Context7/Exa303. **mcp__context7__query-docs** - Check breaking changes v15→v163132After implementation, run **fuse-ai-pilot:sniper** for validation.3334---3536## Overview3738### When to Use3940- Building new React applications with server-first architecture41- Need Server Components for optimal performance and SEO42- Implementing streaming and progressive rendering43- Migrating from Next.js 14/15 to version 1644- Using proxy.ts for route protection (replaces middleware)45- Leveraging Turbopack for faster development builds4647### Why Next.js 164849| Feature | Benefit |50|---------|---------|51| Turbopack default | 2-5x faster builds, 10x faster HMR, Webpack deprecated |52| Cache Components | Explicit caching with `use cache` directive |53| proxy.ts | Full Node.js runtime, replaces Edge middleware |54| React Compiler | Automatic memoization, no manual useMemo/useCallback |55| React 19 | View Transitions, useEffectEvent, Activity component |56| App Router | Nested layouts, parallel routes, intercepting routes |5758---5960## Breaking Changes from v156162### Critical Migration Points63641. **proxy.ts replaces middleware.ts** - Full Node.js runtime, not Edge652. **Turbopack ONLY** - Webpack completely deprecated and removed663. **`use cache` directive** - Replaces Partial Prerendering (PPR)674. **React 19 required** - New hooks and View Transitions API685. **Async params/searchParams** - Must await dynamic route params6970---7172## SOLID Architecture7374### Module-Based Structure7576Pages are thin entry points importing from feature modules:7778- `app/page.tsx` → imports from `modules/public/home/`79- `app/dashboard/page.tsx` → imports from `modules/auth/dashboard/`80- `modules/cores/` → Shared services, utilities, configurations8182### File Conventions8384- **page.tsx** - Route UI component85- **layout.tsx** - Shared UI wrapper86- **loading.tsx** - Suspense loading state87- **error.tsx** - Error boundary88- **not-found.tsx** - 404 handling8990---9192## Core Concepts9394### Server Components (Default)9596All components are Server Components by default. Use `'use client'` directive only when needed for interactivity, hooks, or browser APIs.9798### Caching Strategy99100- **`use cache`** - Mark async functions for caching101- **`cacheTag()`** - Tag cached data for targeted revalidation102- **`cacheLife()`** - Control cache duration (stale, revalidate, expire)103- **`revalidateTag()`** - Invalidate cached data on-demand104105### Data Fetching106107Server Components fetch data directly. Use `fetch()` with native caching or database queries. No need for `getServerSideProps` or `getStaticProps`.108109---110111## Reference Guide112113| Need | Reference |114|------|-----------|115| Initial setup | [installation.md](references/installation.md), [project-structure.md](references/project-structure.md) |116| Migration v15→v16 | [upgrade.md](references/upgrade.md), [middleware-migration.md](references/middleware-migration.md) |117| Routing | [app-router.md](references/app-router.md), [routing-advanced.md](references/routing-advanced.md) |118| Caching | [caching.md](references/caching.md), [cache-components.md](references/cache-components.md) |119| Server Components | [server-components.md](references/server-components.md), [directives.md](references/directives.md) |120| React 19 features | [react-19.md](references/react-19.md), [react-compiler.md](references/react-compiler.md) |121| Route protection | [proxy.md](references/proxy.md), [security.md](references/security.md) |122| SEO/Metadata | [metadata.md](references/metadata.md), [metadata-files.md](references/metadata-files.md) |123| Forms/Actions | [forms.md](references/forms.md), [data-fetching.md](references/data-fetching.md) |124| Deployment | [deployment.md](references/deployment.md), [environment.md](references/environment.md) |125126---127128## Best Practices1291301. **Server Components first** - Only add `'use client'` when necessary1312. **Colocate data fetching** - Fetch data where it's used1323. **Streaming with Suspense** - Wrap slow components in Suspense1334. **proxy.ts over middleware** - Full Node.js runtime for auth1345. **Cache explicitly** - Use `use cache` for expensive operations1356. **Parallel routes** - Load independent UI sections simultaneously136137---138139## Performance140141### Build Optimization142143- **Turbopack** - Incremental compilation, instant HMR144- **React Compiler** - Automatic memoization145- **Tree shaking** - Unused code elimination146- **Code splitting** - Automatic route-based splitting147148### Runtime Optimization149150- **Streaming** - Progressive HTML rendering151- **Partial hydration** - Only hydrate interactive components152- **Image optimization** - Automatic WebP/AVIF conversion153- **Font optimization** - Zero layout shift with next/font