¿Qué hace Next.js 16 Launchpad?
Next.js 16: Turbopack predeterminado (compilaciones 2-5× más rápidas), Cache Components ('use cache') y proxy.ts para control explícito.
Cuándo usarlo
✅ Next.js 16, Turbopack, Cache Components, migración proxy, App Router, React 19.2
❌ Pages Router, Next.js ≤15, preguntas genéricas de React
Requisitos
| Herramienta | Versión |
|---|---|
| Node.js | 20.9.0+ |
| TypeScript | 5.1.0+ |
| React | 19.2+ |
Inicio rápido
# Nuevo proyecto
npx create-next-app@latest my-app
# Actualizar proyecto existente
npx @next/codemod@canary upgrade latest
npm install next@latest react@latest react-dom@latest
Recomendado: TypeScript, ESLint, Tailwind, App Router, Turbopack, alias @/*.
Configuración mínima
// app/layout.tsx
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>{children}</body>
</html>
)
}
// app/page.tsx
export default function Page() {
return <h1>¡Hola, Next.js 16!</h1>
}
Configuración
// next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
reactCompiler: true,
}
export default nextConfig
Cambios v15 → v16
| v15 | v16 |
|---|---|
experimental.turbopack | Predeterminado |
experimental.ppr | cacheComponents |
middleware.ts (Edge) | proxy.ts (Node) |
params síncrono | await params |
Patrones principales
1. Server Components (predeterminado)
export default async function BlogPage() {
const res = await fetch('https://api.example.com/posts')
const posts = await res.json()
return <PostList posts={posts} />
}
2. Cache Components
import { cacheLife } from 'next/cache'
export default async function BlogPage() {
'use cache'
cacheLife('hours')
const posts = await fetch('https://api.example.com/posts').then(r => r.json())
return <PostList posts={posts} />
}
3. Client Components
'use client'
import { useState } from 'react'
export default function Counter() {
const [count, setCount] = useState(0)
return (
<div>
<p>Contador: {count}</p>
<button onClick={() => setCount(count + 1)}>+</button>
</div>
)
}
4. Proxy Boundary
// app/proxy.ts
export function proxy(request: NextRequest) {
if (!request.cookies.get('auth') && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/login', request.url))
}
return NextResponse.next()
}
5. Cache Tags + Server Actions
// app/blog/page.tsx
'use cache'
cacheLife('hours')
cacheTag('blog-posts')
export default async function BlogList() {
const posts = await db.posts.findMany()
return <PostList posts={posts} />
}
// app/actions.ts
'use server'
import { updateTag } from 'next/cache'
export async function createPost(data: PostData) {
await db.posts.create(data)
updateTag('blog-posts')
}
6. Streaming con Suspense
export default function Dashboard() {
return (
<div>
<Suspense fallback={<Skeleton />}>
<RevenueCard />
</Suspense>
<Suspense fallback={<Skeleton />}>
<UsersCard />
</Suspense>
</div>
)
}
async function RevenueCard() {
const data = await db.analytics.revenue()
return <div>{data}</div>
}
Conceptos clave
- Turbopack - Bundler en Rust, compilación incremental, Fast Refresh
- Server Components - Predeterminados en
app/, cero JS en cliente - Client Components -
'use client', hooks, APIs del navegador - Cache Components -
'use cache'+cacheLife()para PPR - Proxy Boundary -
proxy.tspara autenticación/reescrituras/redirecciones - Partial Pre-Rendering - Caparazón estático + streaming dinámico
Checklist de migración
-
APIs de solicitud asíncronas
npx @next/codemod@canary async-request-apiActualizar:
const { slug } = await params -
middleware.ts → proxy.ts
- Renombrar archivo, exportar
proxy - Solo runtime Node (no Edge)
- Renombrar archivo, exportar
-
Actualizaciones de configuración
- Eliminar banderas
experimental.* - Activar
cacheComponents,reactCompiler - Eliminar
serverRuntimeConfig/publicRuntimeConfig
- Eliminar banderas
-
Cache Components
- Reemplazar
experimental.pprconcacheComponents: true - Envolver secciones dinámicas con
<Suspense>
- Reemplazar
-
Imágenes
- Configurar
images.localPatternspara cadenas de consulta
- Configurar
Consulta references/nextjs16-migration-playbook.md para la guía completa.
Problemas comunes
❌ Mezclar 'use cache' con APIs de tiempo de ejecución (cookies(), headers())
❌ Falta de <Suspense> cuando Cache Components está activado
❌ Importaciones de Sass con tilde bajo Turbopack
❌ Ejecutar proxy.ts en tiempo de ejecución Edge
✅ Leer cookies/encabezados primero, pasarlos como props a componentes en caché
✅ Envolver hijos dinámicos en <Suspense>
✅ Usar importaciones Sass estándar
✅ Usar tiempo de ejecución Node para proxy
Guía de decisiones
¿Activar Cache Components? → Sí para contenido estático/semiestático → No para paneles totalmente dinámicos
¿Dónde vive la autenticación?
→ proxy.ts para verificaciones entre rutas
→ Route handlers para lógica específica de la API
¿Cuándo usar 'use client'?
→ Solo cuando necesites hooks, estado o APIs del navegador
→ Mantén los componentes de presentación en el lado del servidor
Patrones de producción
Comercio electrónico
// Página de producto con streaming
export default async function Product({ params }) {
const { id } = await params
const product = await db.products.findById(id)
return (
<>
<ProductInfo product={product} />
<Suspense fallback={<ReviewsSkeleton />}>
<Reviews productId={id} />
</Suspense>
</>
)
}
Panel de autenticación
// proxy.ts
export function proxy(request: NextRequest) {
const session = request.cookies.get('session')
if (!session && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/login', request.url))
}
}
Consulta references/nextjs16-advanced-patterns.md para más plantillas.
Rendimiento
- Mantén Turbopack habilitado (desactívalo con
--webpacksolo si es necesario) - Paraleliza las solicitudes con
Promise.all - Usa
<Suspense>para límites de streaming - Habilita la caché del sistema de archivos para repositorios grandes
Seguridad
- Usa el paquete
server-only+ React Taint API - Mantén la autenticación en
proxy.ts - Valida las entradas en Server Actions
- Protege las variables de entorno con el prefijo
NEXT_PUBLIC_ - Extrae cookies/encabezados antes de ámbitos en caché
Despliegue
- Vercel: Configuración cero
- Docker/Node:
output: 'standalone' - Monitorea los tiempos de compilación (se espera 2-5× de aceleración)
- Configura los ciclos de vida de la caché para que coincidan con la CDN
Archivos de referencia
- references/nextjs16-reference.md - Instalación/configuración/listas de verificación
- references/nextjs16-migration-playbook.md - Guía de migración con codemods
- references/nextjs16-advanced-patterns.md - Patrones de streaming, caché y autenticación
- references/NEXTJS_16_COMPLETE_GUIDE.md - Documentación completa
- scripts/bootstrap-nextjs16.ps1 - Script de configuración automatizado
- assets/app-router-starter/ - Implementación de referencia
Recursos
- Documentación: https://nextjs.org/docs
- GitHub: https://github.com/vercel/next.js
Versión: 1.1.0 | Actualizado: 2025-12-27