La arquitectura documentada de Next.js
Next.js está construido en torno a React y proporciona una capa de framework para el enrutamiento, renderizado, acceso a datos, endpoints de servidor, compilación y empaquetado. Esto describe el modelo público de programación documentado para las aplicaciones; no revela la infraestructura privada utilizada para operar nextjs.org.
En el App Router, el árbol de rutas se organiza mediante archivos para páginas, layouts, estados de carga, errores y comportamientos relacionados. Los layouts y las páginas son Server Components de forma predeterminada. Los Client Components definen subárboles ejecutados en el navegador para el estado, los controladores de eventos, los efectos y las API exclusivas del navegador.
Capas públicas del framework
| Capa | Responsabilidad documentada |
|---|---|
| Componentes de React | Componer la interfaz de usuario y definir árboles de componentes del servidor o del cliente |
| App Router o Pages Router | Asignar la estructura de la aplicación a rutas mediante diferentes modelos de Next.js |
| Sistema de renderizado | Producir salidas prerenderizadas o generadas al recibir solicitudes y coordinar la transmisión progresiva cuando corresponda |
| Almacenamiento en caché y revalidación | Controlar la reutilización y la vigencia conforme al comportamiento de las rutas y los datos |
| Route Handlers | Implementar endpoints HTTP dentro de una aplicación con App Router |
| Herramientas de compilación | Compilar y empaquetar el código y los recursos de la aplicación para despliegues compatibles |
Una ruta de Next.js puede incluir contenido renderizado en el servidor e interacción específica del cliente. La presencia de un Client Component no convierte a todos sus antecesores en una aplicación renderizada en el navegador, aunque el límite de cliente elegido afecta a los módulos incluidos para el navegador.
Opciones de entrega
- La exportación estática produce archivos para proyectos que no necesitan funciones de servidor no compatibles.
- El prerenderizado prepara la salida de una ruta antes de una solicitud individual.
- El renderizado dinámico genera la salida mediante información disponible al recibir la solicitud.
- El almacenamiento en caché y la revalidación gestionan la reutilización y la vigencia entre esos extremos.
- Se requiere un entorno de ejecución compatible para el comportamiento al recibir solicitudes y otros comportamientos dependientes del servidor.
La guía oficial de despliegue documenta el alojamiento propio y los adaptadores de plataformas, por lo que Vercel no es un requisito técnico para todas las aplicaciones Next.js. La cobertura de funciones puede variar entre entornos. Los equipos deben verificar el enrutamiento, la caché, el comportamiento de las imágenes, la revalidación, la transmisión progresiva y los Route Handlers respecto al destino seleccionado, en lugar de deducir la compatibilidad de una compilación realizada correctamente.
