Guía de despliegue de Bolt.new · revisada el 25 de septiembre de 2026
¿Bolt.new no publica tu app? Comprueba en qué paso falla
Una vista previa en blanco, un fallo al publicar desde Bolt y una compilación fallida en otro alojamiento son problemas distintos. Identifica primero dónde ocurre el error y sigue las comprobaciones adecuadas antes de cambiar de proveedor.
Paso 1
La vista previa aparece en blanco
Puede fallar el navegador o WebContainer antes de que la app llegue al alojamiento. Prueba con un navegador basado en Chromium y comprueba si una extensión o VPN está bloqueando Bolt.
Paso 2
Falla la publicación de Bolt
Lee el error que aparece al pulsar Publicar. Si funciona la dirección generada .bolt.host pero falla tu dominio, comprueba el estado del dominio y los registros DNS antes de volver a compilar.
Paso 3
Falla la compilación en otro proveedor
Usa el registro de compilación de ese alojamiento. El primer error concreto suele señalar una dependencia, configuración o variable que falta.
Analiza el registro de otro alojamiento
Pega un registro sin secretos para buscar errores de compilación habituales. El análisis se ejecuta en tu navegador; no se conecta a Bolt ni a tu proveedor, y no sube ni guarda el texto.
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.
¿Dónde estás intentando publicar?
Publicación dentro de Bolt
El alojamiento integrado de Bolt publica el proyecto en una dirección .bolt.host. Su centro de ayuda indica que todos los usuarios pueden publicar ahí; los dominios propios están disponibles para usuarios de pago. Si funciona la dirección generada pero falla tu dominio, comprueba su estado y los registros DNS antes de volver a compilar.
Publicación en Vercel, Netlify u otro proveedor
Trata el despliegue externo como un proyecto aparte. Comprueba que el proveedor usa el repositorio y la carpeta correctos, ejecuta el comando de compilación de la app y tiene las variables de entorno necesarias. Vercel permite desplegar un frontend Vite, pero el servidor y los datos conectados requieren una configuración compatible.
La web carga, pero falla el inicio de sesión o los datos
Puede ser un problema de configuración o de un servicio de producción, no necesariamente de la compilación del frontend. Comprueba la base de datos, las URL de retorno de autenticación y las variables del entorno. Cambiar de alojamiento no migra automáticamente la base de datos de Bolt. Bolt advierte que sustituir la conexión puede causar pérdida de datos: haz una copia y sigue primero las instrucciones de migración.
Guía de Bolt sobre conexiones y migración de bases de datos¿Conviene sacar una app de Bolt?
Mantén Bolt si…
- la app se publica bien y los servicios integrados cubren lo que necesitas;
- quieres gestionar alojamiento, dominio y base de datos desde Bolt;
- el dominio y las condiciones del plan sirven para tu proyecto.
Compara otros alojamientos si…
- necesitas un entorno, proveedor o flujo de publicación específico;
- la app ya usa servicios externos que quieres gestionar junto al alojamiento;
- has revisado el código, la base de datos, los secretos, las condiciones y el coste total.
Antes de cambiar, sincroniza o guarda una copia del proyecto y publica una versión de prueba. Comprueba las páginas, el inicio de sesión, el guardado de datos y el dominio antes de enviar a tus visitantes al nuevo alojamiento.
Más ayuda para publicar tu app
Fuentes oficiales
Información revisada con la documentación pública el 25 de septiembre de 2026. Percent to Prompts es independiente y no recibe actualmente comisiones de los proveedores mencionados.
Lee también la guía en inglés.