Guías de frameworks

Estas guías despliegan una aplicación típica de cada tipo desde un repositorio Git. Cada una muestra una aplicación mínima, qué detecta Zenavo, los ajustes que necesita y los errores que más vemos.

Guía	Cubre
Next.js	Next.js con App Router o Pages Router, next start u output: 'standalone'
Node.js y Express	Express, Fastify, Koa y cualquier servidor Node.js
Python	FastAPI, Django y Flask
Go	net/http, Gin, Echo, Fiber y cualquier servidor Go
Laravel	Laravel sobre PHP-FPM y nginx, con migraciones y Vite
Spring Boot	Spring Boot con Maven o Gradle
Sitios estáticos	HTML plano y sitios compilados: salida de Vite, React, Vue, Astro, Hugo

Todas las guías dan por hecho que tienes un servidor y un proyecto: consulta el Inicio rápido.

Lo que todas tienen en común

• Sin Dockerfile, zbpack compila la aplicación. Revisa lo que detectó en Build Plan Preview antes de desplegar. Si hay un Dockerfile en el directorio raíz, se usa ese tal cual.
• Escucha en 0.0.0.0 y en $PORT. Zenavo pone en PORT el puerto del servicio, 8080 en las compilaciones de zbpack. Un servidor que solo escucha en localhost o 127.0.0.1 es inalcanzable y el despliegue nunca está sano.
• La configuración viene de las variables. Defínelas en la pestaña Variable del servicio; los datos de conexión de una base de datos llegan como <NAME>_CONNECTION_STRING y similares (Bases de datos). Las variables cambian en el siguiente despliegue.
• El sistema de archivos no se conserva entre despliegues ni reinicios. Guarda las subidas y otros archivos que deban sobrevivir en un volumen, o en una base de datos o almacenamiento de objetos.
• En monorepos, pon el Root Directory del servicio en la carpeta de la aplicación, y los watch paths para compilar solo cuando cambie.