Solución JavaScript full-stack

Entorno de desarrollo local de Next.js con FlyEnv

Construye, ejecuta y prueba aplicaciones Next.js con el runtime de Node.js, tu gestor de paquetes preferido, bases de datos locales, Redis, dominios personalizados y HTTPS, todo gestionado en un único workspace.

Descargar FlyEnv Leer la guía de configuración de Next.js

Un stack local práctico para Next.js

Next.js puede empezar como un único proceso de Node.js, pero un proyecto full-stack real suele necesitar un runtime, herramientas de build, servicios de datos y un origen accesible desde el navegador que permanezcan coordinados.

Runtime de Node.js

Ejecuta el servidor de Next.js, las herramientas de desarrollo y los scripts de build con una versión compatible con el proyecto.

Función de Node.js

Gestor de paquetes

Usa el gestor de paquetes y el lockfile que ya espera el repositorio: npm, pnpm, Yarn o Bun.

Base de datos de la aplicación

Conecta PostgreSQL o MySQL cuando las server actions, los route handlers o la capa de aplicación necesiten datos persistentes.

Función de base de datos

Redis opcional

Añade Redis para caché, sesiones, colas, limitación de tráfico o tareas en segundo plano cuando la aplicación lo utilice.

Función de Redis

Origen local

Usa Nginx o Caddy cuando la aplicación necesite un hostname local estable, comportamiento de proxy o varios servicios.

Función de Nginx

HTTPS para flujos del navegador

Prueba OAuth, cookies seguras, webhooks, service workers y otras funciones del navegador en un origen local de confianza.

Función de HTTPS local

Ciclo de vida de Next.js en FlyEnv

Mantén juntos el runtime del proyecto y el flujo de paquetes, desde la instalación de dependencias hasta un build similar al de producción.

Instalar dependencias

Resuelve el lockfile con el toolchain seleccionado para el proyecto.

npm install

Ejecutar servidor de desarrollo

Ejecuta localmente App Router, Server Components y route handlers.

npm run dev

Build

Detecta problemas de renderizado en producción y de dependencias antes del despliegue.

npm run build

Iniciar producción

Sirve la aplicación compilada mediante un dominio local y HTTPS.

npm start

Flujo de trabajo del proyecto

npm pnpm Yarn Bun Versiones de Node.js Startup Groups

Frontend y backend en un único workspace local

Un proyecto Next.js puede servir la UI, los route handlers, las server actions y las llamadas a API desde una aplicación, manteniendo a la vez sus servicios de datos locales.

Navegador y origen local

Abre https://next-app.test para probar cookies, OAuth, webhooks e integraciones del cliente.

UI y route handlers

Renderiza páginas, server actions, endpoints de API y lógica backend-for-frontend desde el proyecto Next.js.

Aplicación Next.js

App Router · Server Components · Route Handlers · Server Actions

FrontendBackend

PostgreSQL o MySQL

Guarda usuarios, contenido, pedidos y otros datos de aplicación usados por la capa del servidor.

Redis cuando sea necesario

Proporciona caché, sesiones, colas, límites de tráfico u otro estado compartido de acceso rápido.

Navegador / HTTPSAplicación Next.jsPostgreSQL / Redis

Runtime del proyecto y gestor de paquetes

Node.js es el runtime de la aplicación; el gestor de paquetes forma parte del toolchain del proyecto. Mantén visibles ambas decisiones en lugar de depender de una instalación global.

FlyEnv gestiona el runtime y los servicios locales alrededor del proyecto sin sustituir npm, pnpm, Yarn, Bun ni los scripts que ya utiliza el proyecto.

Versión de Node.js

Usa la versión requerida por Next.js, sus dependencias y el destino de despliegue.

Abrir función de Node.js

Gestor de paquetes

Mantén npm, pnpm, Yarn o Bun alineados con el lockfile y los scripts que utiliza el proyecto.

El lockfile forma parte del proyecto

FlyEnv Startup Groups para iniciar juntos los servicios del proyecto — Usa un Startup Group para iniciar con un clic la aplicación Next.js, la base de datos, Redis y otros servicios locales.

Inicia un proyecto Next.js nuevo o ejecuta uno existente

Elige el flujo que corresponda al estado actual del proyecto y mantén su runtime y sus servicios de apoyo en un único workspace.

Crear un proyecto Next.js nuevo

1Abre Node.js → Nuevo proyecto y elige la plantilla de Next.js.
2Selecciona la versión de Node.js y el gestor de paquetes que usará el proyecto.
3Instala las dependencias y conserva el lockfile junto al código fuente.
4Añade el dominio local, HTTPS y los servicios de base de datos cuando sea necesario.
5Crea un Startup Group para la aplicación y sus servicios de apoyo.

Ejecutar un proyecto Next.js existente

1Abre el repositorio e identifica sus requisitos de Node.js y del gestor de paquetes.
2Selecciona la versión de Node.js correspondiente e instala desde el lockfile.
3Inicia PostgreSQL, MySQL, Redis u otro servicio configurado.
4Configura el proxy local, el hostname y HTTPS para los flujos del navegador.
5Usa next dev para desarrollar o next build y next start para una comprobación similar a producción.

Leer la guía completa de configuración de Next.js

Por qué usar FlyEnv para desarrollar con Next.js

Un flujo local más predecible para proyectos que pasan de la UI del navegador al código de servidor, los builds y los servicios de datos.

Ajusta Node.js al proyecto
Mantén cada proyecto Next.js en una versión del runtime compatible con sus dependencias y su destino de despliegue.
Proyecto A → Node.js 20 · Proyecto B → Node.js 22
Ejecuta juntos la app y sus servicios
Inicia la aplicación Next.js, la base de datos, Redis y el proxy local como un grupo cuando necesites el stack completo.
Next.js + PostgreSQL + Redis → Startup Group
Prueba un origen local real
Usa un hostname local legible y HTTPS para comportamientos del navegador que localhost por sí solo no puede reproducir.
Mantén aislados los proyectos full-stack
Conserva el runtime, la URL local, la base de datos, Redis y los servicios de apoyo de cada proyecto en su propio workspace.

Preguntas frecuentes sobre Next.js

Preguntas habituales sobre el uso de FlyEnv para proyectos Next.js locales.

¿Pueden distintos proyectos Next.js usar diferentes versiones de Node.js?

Sí. FlyEnv permite que cada proyecto use la versión de Node.js que necesita, algo útil cuando las aplicaciones o sus dependencias siguen ciclos de lanzamiento distintos.

¿FlyEnv sustituye al gestor de paquetes de Next.js?

No. Sigue usando el gestor de paquetes y el lockfile elegidos por el repositorio. FlyEnv proporciona el runtime del proyecto y los servicios locales alrededor de ese toolchain.

¿Todos los proyectos Next.js necesitan una base de datos?

No. Un proyecto solo de frontend quizá necesite únicamente Node.js. Añade PostgreSQL o MySQL cuando la aplicación use datos del servidor, route handlers o contenido persistente.

¿Cuándo debería añadir Redis?

Añade Redis cuando la aplicación use caché, sesiones, colas, limitación de tráfico u otro patrón de estado compartido rápido. Es opcional, no un requisito de Next.js.

¿Puedo probar OAuth y webhooks en un dominio local de Next.js?

Sí. Configura un dominio local con HTTPS de confianza para que las cookies del navegador, los callbacks de OAuth, los webhooks y otras funciones de origen seguro se comporten de forma más parecida a producción.

¿FlyEnv puede ejecutar next build y next start?

Sí. FlyEnv proporciona el runtime de Node.js y los servicios locales; los scripts del propio proyecto siguen ejecutando next build y next start para una comprobación local similar a producción.