Buenas Prácticas de Next.js
Principios para el desarrollo con el App Router de Next.js.
1. Componentes de Servidor vs Cliente
Árbol de Decisión
¿Necesita...?
│
├── useState, useEffect, manejadores de eventos
│ └── Componente Cliente ('use client')
│
├── Obtención directa de datos, sin interactividad
│ └── Componente Servidor (por defecto)
│
└── ¿Ambos?
└── Dividir: Servidor padre + Cliente hijo
Por Defecto
| Tipo | Uso |
|---|
| Servidor | Obtención de datos, layout, contenido estático |
| Cliente | Formularios, botones, UI interactiva |
2. Patrones de Obtención de Datos
Estrategia de Fetch
| Patrón | Uso |
|---|
| Por defecto | Estático (almacenado en caché en build) |
| Revalidar | ISR (actualización basada en tiempo) |
| Sin almacenar | Dinámico (cada solicitud) |
Flujo de Datos
| Fuente | Patrón |
|---|
| Base de datos | Fetch en Componente Servidor |
| API | fetch con caché |
| Entrada del usuario | Estado del cliente + acción del servidor |
3. Principios de Enrutamiento
Convenciones de Archivos
| Archivo | Propósito |
|---|
page.tsx | UI de la ruta |
layout.tsx | Layout compartido |
loading.tsx | Estado de carga |
error.tsx | Límite de error |
not-found.tsx | Página 404 |
Organización de Rutas
| Patrón | Uso |
|---|
Grupos de rutas (nombre) | Organizar sin cambiar la URL |
Rutas paralelas @slot | Múltiples páginas al mismo nivel |
Interceptación (.) | Superposiciones modales |
4. Rutas de API
Manejadores de Rutas
| Método | Uso |
|---|
| GET | Leer datos |
| POST | Crear datos |
| PUT/PATCH | Actualizar datos |
| DELETE | Eliminar datos |
Buenas Prácticas
- Validar entrada con Zod
- Devolver códigos de estado adecuados
- Manejar errores de forma elegante
- Usar runtime Edge cuando sea posible
5. Principios de Rendimiento
Optimización de Imágenes
- Usar el componente next/image
- Establecer prioridad para contenido visible inicial
- Proporcionar placeholder borroso
- Usar tamaños responsivos
Optimización del Bundle
- Importaciones dinámicas para componentes pesados
- División de código basada en rutas (automática)
- Analizar con bundle analyzer
6. Metadatos
Estáticos vs Dinámicos
| Tipo | Uso |
|---|
| Exportación estática | Metadatos fijos |
| generateMetadata | Dinámicos por ruta |
Etiquetas Esenciales
- title (50-60 caracteres)
- description (150-160 caracteres)
- Imágenes Open Graph
- URL canónica
7. Estrategia de Caché
Capas de Caché
| Capa | Control |
|---|
| Solicitud | opciones de fetch |
| Datos | revalidate/tags |
| Ruta completa | configuración de ruta |
Revalidación
| Método | Uso |
|---|
| Basada en tiempo | revalidate: 60 |
| Bajo demanda | revalidatePath/Tag |
| Sin caché | no-store |
8. Acciones del Servidor
Casos de Uso
- Envío de formularios
- Mutaciones de datos
- Disparadores de revalidación
Buenas Prácticas
- Marcar con 'use server'
- Validar todas las entradas
- Devolver respuestas tipadas
- Manejar errores
9. Anti-Patrones
| ❌ No Hacer | ✅ Hacer |
|---|
| 'use client' en todos lados | Servidor por defecto |
| Fetch en componentes cliente | Fetch en servidor |
| Omitir estados de carga | Usar loading.tsx |
| Ignorar límites de error | Usar error.tsx |
| Grandes bundles cliente | Importaciones dinámicas |
10. Estructura del Proyecto
app/
├── (marketing)/ # Grupo de rutas
│ └── page.tsx
├── (dashboard)/
│ ├── layout.tsx # Layout del dashboard
│ └── page.tsx
├── api/
│ └── [resource]/
│ └── route.ts
└── components/
└── ui/
Recuerda: Los Componentes de Servidor son el valor por defecto por una razón. Empieza ahí, añade cliente solo cuando sea necesario.
Cuándo Usar
Este skill es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la visión general.
Limitaciones
- Usa este skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trates la salida como un sustituto de validación específica del entorno, pruebas o revisión de expertos.
- Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.