nextjs-16
Expert Next.js 16 development with Turbopack default, Cache Components, use cache directive, proxy.ts, React Compiler, and React 19.2. Use when working with Next.js projects, App Router, Server Components, caching, routing, data fetching, or deployment.
📖 中文导读:Expert Next.js 16 development with Turbopack default, Cache Components, use cache directive, proxy.ts, React Compiler, and React 19.2. Use when working with Next.js projects, App Router, Server Components, caching, routing, data fetching, or deployment. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: nextjs-16 description: Expert Next.js 16 development with Turbopack default, Cache Components, use cache directive, proxy.ts, React Compiler, and React 19.2. Use when working with Next.js projects, App Router, Server Components, caching, routing, data fetching, or deployment.
Next.js 16 Expert
Overview
Next.js 16 (released October 21, 2025) is a major release with Turbopack as default bundler, Cache Components model, and significant architectural improvements.
Quick Start
# Upgrade existing project
bunx @next/codemod@canary upgrade latest
# Or manual upgrade
bun add next@latest react@latest react-dom@latest
# Or new project
bunx create-next-app@latest
Key Features
1. Turbopack (Now Default)
- 2-5x faster production builds
- Up to 10x faster Fast Refresh
- Filesystem caching (beta)
To use webpack instead:
next dev --webpack
next build --webpack
2. Cache Components
New explicit caching model with use cache directive:
// next.config.ts
const nextConfig = {
cacheComponents: true,
};
3. proxy.ts (Replaces middleware.ts)
Clearer network boundary, runs on Node.js runtime:
// proxy.ts
export default function proxy(request: NextRequest) {
return NextResponse.redirect(new URL('/home', request.url));
}
4. React Compiler (Stable)
Automatic memoization:
// next.config.ts
const nextConfig = {
reactCompiler: true,
};
bun add babel-plugin-react-compiler@latest
5. React 19.2 Features
- View Transitions: Animate elements in Transitions
- useEffectEvent: Extract non-reactive Effect logic
- Activity: Background rendering with state preservation
Version Requirements
| Requirement | Version |
|---|---|
| Node.js | 20.9+ (LTS) |
| TypeScript | 5.1.0+ |
| Chrome/Edge | 111+ |
| Firefox | 111+ |
| Safari | 16.4+ |
Documentation Structure
This skill contains the complete official Next.js 16 documentation:
App Router (Recommended)
- 01-app/01-getting-started - Installation, project structure, layouts, pages
- 01-app/02-guides - Authentication, forms, caching, testing, deployment
- 01-app/03-api-reference - Components, functions, config, CLI
Pages Router (Legacy)
- 02-pages/01-getting-started - Installation for Pages Router
- 02-pages/02-guides - Pages Router specific guides
- 02-pages/03-building-your-application - Routing, rendering, data fetching
- 02-pages/04-api-reference - Pages Router API
Architecture
- 03-architecture - Accessibility, Fast Refresh, compiler, browsers
Community
- 04-community - Contribution guide, Rspack
Breaking Changes from v15
Removals
- AMP support removed
next lintremoved (use ESLint/Biome directly)serverRuntimeConfig/publicRuntimeConfigremoved- Sync
params/searchParamsaccess removed - Sync
cookies()/headers()/draftMode()removed
Behavior Changes
- Turbopack is default bundler
images.minimumCacheTTLdefault: 4 hoursrevalidateTag()requires cacheLife profile- Parallel routes require explicit
default.js
Deprecations
middleware.ts→proxy.tsnext/legacy/image→next/imageimages.domains→images.remotePatterns
Instructions
- ALWAYS use App Router patterns for new projects
- Use
use cachedirective for explicit caching - Use
proxy.tsinstead ofmiddleware.ts - Enable React Compiler for automatic memoization
- Use
updateTag()in Server Actions for immediate updates - Use
revalidateTag()with cacheLife for background revalidation - Reference the complete docs in subdirectories for detailed patterns
Documentation Reference
For latest official docs, use Context7 MCP:
mcp__context7__get-library-docs with context7CompatibleLibraryID="/vercel/next.js"
Official site: https://nextjs.org/docs