Guía de despliegue · 25 de septiembre de 2026
¿Tu app creada con IA no se despliega?
Pega el registro del despliegue para detectar algunos errores habituales y saber qué comprobar primero. Sirve para proyectos de Lovable, Bolt, Cursor, Claude Code y otras herramientas que generan código.
Analiza el registro del error
La herramienta compara el texto con patrones de errores comunes y muestra comprobaciones concretas. No envía el registro a un servicio de IA ni modifica tu proyecto.
Detecta algunos errores de compilación habituales. Es una primera revisión, no un análisis completo del código.
0 / 16.000El análisis se hace en este navegador y el texto no se guarda ni se envía. Elimina claves de API, contraseñas, tokens y direcciones privadas antes de pegar el registro.
Cómo funciona la herramienta
Busca la primera pista concreta.
- Busca fallos habituales como paquetes que faltan, variables de entorno, errores de TypeScript y carpetas de publicación.
- El análisis se ejecuta aquí. No se conecta a servicios de IA ni a cuentas de alojamiento.
- No modifica el proyecto. Revisa las sugerencias y confirma la causa en el código y la configuración del proveedor.
Si estás llevando una app de Lovable a Vercel, comprueba también el requisito de versión en la guía y comprobador de compatibilidad de Lovable con Vercel.
Si todavía estás eligiendo hosting, consulta la comparativa para alojar apps de Lovable.
¿Usas Bolt.new? Consulta la guía para distinguir fallos de vista previa, publicación en Bolt y despliegue externo.
Errores habituales al publicar una app
“Missing script: build”
El alojamiento está ejecutando un comando que no existe en la sección scripts de package.json. Comprueba cuál es el comando de compilación del proyecto y configúralo en el panel o añade el script correcto.
“Module not found” o “Could not resolve”
Revisa que el archivo exista en el repositorio, que las mayúsculas de la ruta coincidan y que el paquete esté declarado en las dependencias. La compilación del servidor puede distinguir entre letras mayúsculas y minúsculas aunque tu equipo no lo haga.
“Missing environment variable”
Añade la variable indicada en el panel del proveedor para el entorno que falla (vista previa o producción) y vuelve a desplegar. No subas contraseñas ni claves privadas al repositorio, y elimina sus valores antes de compartir registros.
Versión de Node.js incompatible
El registro puede indicar que una dependencia necesita otra versión de Node.js. Comprueba el requisito del paquete, selecciona una versión compatible en el panel de alojamiento y usa una versión equivalente en local.
package.json y el archivo de bloqueo no coinciden
Si cambiaste dependencias, actualiza el archivo de bloqueo con el mismo gestor de paquetes del proyecto y súbelo junto con package.json. Configura en el proveedor el comando de instalación correspondiente.
No se encuentra la carpeta de publicación
Comprueba dónde genera los archivos tu framework y usa esa carpeta en la configuración del alojamiento. No todos los proyectos generan una carpeta dist; las apps con renderizado en servidor necesitan una configuración compatible con su framework.
“window is not defined” o “document is not defined”
El código usa una función del navegador durante la compilación del servidor. Busca el primer archivo indicado y mueve ese código al componente o flujo que se ejecuta en el navegador.
Antes de volver a desplegar
- Busca el primer error específico; el mensaje final “command exited with code 1” suele ser genérico.
- Ejecuta en local el comando de compilación de producción y corrige el primer fallo que aparezca.
- Comprueba la carpeta raíz, el comando de compilación, la versión de Node.js y las variables del entorno.
- Publica de nuevo y revisa el registro del nuevo intento.
La guía oficial de Vercel para solucionar errores de compilación recomienda localizar la causa concreta en el registro y reproducir la compilación en local.
Cuando la app compile, elige dónde publicarla
Vercel
Encaja de forma directa con proyectos Next.js. El plan Hobby es para uso personal y no comercial; comprueba los términos si la app va a generar ingresos.
Ver planes y condicionesHostinger
Ofrece alojamiento administrado para apps Node.js en planes elegibles Business Web y Cloud. Confirma requisitos, precio de renovación y compatibilidad antes de migrar.
Ver requisitos de Node.jsDigitalOcean App Platform
Puede alojar apps con servicios adicionales. Calcula juntos los contenedores, bases de datos y transferencia de datos que necesite el proyecto.
Consultar precios actualesPara comparar una ruta según el framework, las necesidades de servidor y el uso comercial, abre el buscador de alojamiento (en inglés).
Esta herramienta ofrece una primera orientación y no garantiza identificar todos los fallos. Los enlaces son informativos y no son enlaces de afiliado. Información de proveedores revisada el 25 de septiembre de 2026.