Aplicaciones Next.js 16
Construye aplicaciones Next.js 16 correctamente con un diseño distintivo.
Cambios Críticos de Ruptura (Next.js 16)
1. params y searchParams Ahora son Promesas
ESTE ES EL ERROR MÁS COMÚN.
// INCORRECTO - Patrón de Next.js 15 (FALLARÁ)
export default function Page({ params }: { params: { id: string } }) {
return <div>ID: {params.id}</div>
}
// CORRECTO - Patrón de Next.js 16
export default async function Page({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = await params
return <div>ID: {id}</div>
}
2. Componentes Cliente Necesitan el Hook use()
"use client"
import { use } from "react"
export default function ClientPage({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = use(params)
return <div>ID: {id}</div>
}
3. searchParams También es Asíncrono
export default async function Page({
searchParams,
}: {
searchParams: Promise<{ page?: string }>
}) {
const { page } = await searchParams
return <div>Page: {page ?? "1"}</div>
}
Patrones Centrales
Configuración del Proyecto
npx create-next-app@latest my-app --typescript --tailwind --eslint
cd my-app
# Añadir shadcn/ui
npx shadcn@latest init
npx shadcn@latest add button form dialog table sidebar
Layout de App Router
// app/layout.tsx
export default function RootLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="en">
<body className="min-h-screen">
{children}
</body>
</html>
)
}
Rutas Dinámicas
// app/tasks/[id]/page.tsx
export default async function TaskPage({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = await params
const task = await getTask(id)
return (
<main>
<h1>{task.title}</h1>
</main>
)
}
Server Actions
// app/actions.ts
"use server"
import { revalidatePath } from "next/cache"
export async function createTask(formData: FormData) {
const title = formData.get("title") as string
await db.insert(tasks).values({ title })
revalidatePath("/tasks")
}
// Uso en componente
<form action={createTask}>
<input name="title" />
<button type="submit">Crear</button>
</form>
Rutas API
// app/api/tasks/route.ts
import { NextResponse } from "next/server"
export async function GET() {
const tasks = await db.select().from(tasksTable)
return NextResponse.json(tasks)
}
export async function POST(request: Request) {
const body = await request.json()
const task = await db.insert(tasksTable).values(body).returning()
return NextResponse.json(task, { status: 201 })
}
Middleware → proxy.ts
// proxy.ts (reemplaza a middleware.ts en Next.js 16)
import { NextRequest } from "next/server"
export function proxy(request: NextRequest) {
// Verificación de autenticación
const token = request.cookies.get("token")
if (!token && request.nextUrl.pathname.startsWith("/dashboard")) {
return Response.redirect(new URL("/login", request.url))
}
}
export const config = {
matcher: ["/dashboard/:path*"],
}
Obtención de Datos
Componente Servidor (Por Defecto)
// Esto se ejecuta en el servidor - puede usar async/await directamente
async function TaskList() {
const tasks = await fetch("https://api.example.com/tasks", {
cache: "no-store", // SSR, o
// next: { revalidate: 60 } // ISR
}).then(r => r.json())
return (
<ul>
{tasks.map(task => <li key={task.id}>{task.title}</li>)}
</ul>
)
}
Componente Cliente
"use client"
import useSWR from "swr"
const fetcher = (url: string) => fetch(url).then(r => r.json())
export function ClientTaskList() {
const { data, error, isLoading } = useSWR("/api/tasks", fetcher)
if (isLoading) return <div>Cargando...</div>
if (error) return <div>Error al cargar tareas</div>
return (
<ul>
{data.map(task => <li key={task.id}>{task.title}</li>)}
</ul>
)
}
Estructura del Proyecto
app/
├── layout.tsx # Layout raíz
├── page.tsx # Página de inicio
├── globals.css # Estilos globales
├── api/ # Rutas API
│ └── tasks/route.ts
├── tasks/
│ ├── page.tsx # /tasks
│ └── [id]/page.tsx # /tasks/:id
├── actions.ts # Server actions
└── proxy.ts # Proxy de solicitudes (middleware)
components/
├── ui/ # Componentes shadcn/ui
└── task-list.tsx # Componentes de la aplicación
lib/
├── db.ts # Conexión a base de datos
└── utils.ts # Utilidades
Next.js DevTools MCP
Usa el servidor next-devtools-mcp para diagnóstico en tiempo de ejecución y automatización del desarrollo.
Configuración
claude mcp add next-devtools npx next-devtools-mcp@latest
O en settings.json:
{
"mcpServers": {
"next-devtools": {
"type": "stdio",
"command": "npx",
"args": ["next-devtools-mcp@latest"]
}
}
}
Herramientas Disponibles
| Herramienta | Propósito |
|---|---|
init | Establecer contexto con herramientas disponibles y mejores prácticas |
nextjs_docs | Buscar y obtener documentación oficial de Next.js |
browser_eval | Automatizar pruebas de navegador con Playwright |
nextjs_index | Descubrir servidores de desarrollo Next.js en ejecución |
nextjs_call | Ejecutar herramientas MCP en servidores de desarrollo en ejecución |
upgrade_nextjs_16 | Actualización automatizada con codemods |
enable_cache_components | Configurar Cache Components para Next.js 16 |
Casos de Uso Clave
1. Obtener Errores en Tiempo Real
"¿Qué errores de compilación hay en mi aplicación Next.js?"
"Muéstrame los errores de TypeScript en el proyecto actual"
2. Depurar Problemas de Tiempo de Ejecución
"Revisa los registros del servidor de desarrollo en busca de errores"
"¿Qué errores de tiempo de ejecución están ocurriendo en la página del dashboard?"
3. Asistencia para Actualización
"Actualiza este proyecto a Next.js 16"
"Habilita cache components para esta aplicación"
4. Consulta de Documentación
"¿Cómo uso el componente Image en Next.js 16?"
"¿Cuál es la forma correcta de manejar rutas dinámicas?"
Endpoint MCP de Next.js 16
Next.js 16+ expone un endpoint MCP integrado en http://localhost:3000/_next/mcp (o el puerto de tu servidor de desarrollo). Las herramientas de desarrollo MCP descubren y se conectan automáticamente a los servidores en ejecución.
Verificación
Ejecuta: python3 scripts/verify.py
Esperado: ✓ building-nextjs-apps skill ready
Si la Verificación Falla
- Verifica que la carpeta references/ contenga nextjs-16-patterns.md
- Detente e informa si sigue fallando
Habilidades Relacionadas
- styling-with-shadcn - Componentes de UI para aplicaciones Next.js
- fetching-library-docs - Últimos documentos de Next.js:
--library-id /vercel/next.js --topic routing - configuring-better-auth - OAuth/SSO para aplicaciones Next.js
Referencias
- references/nextjs-16-patterns.md - Patrones completos de Next.js 16
- references/frontend-design.md - Directrices estéticas para UI distintivo
- references/datetime-patterns.md - Manejo de UTC/zona horaria para entradas datetime-local