Cómo exportar mi proyecto de Bolt.new y alojarlo fuera
Para sacar la app de Bolt.new, obtenga el código con Download o con GitHub, pase la base a su propia cuenta de Supabase con Claim, recree los secretos y publique en un servidor suyo. Al final, mueva el dominio. Bolt confirma que el código es suyo; el trabajo está en la base y en la configuración que queda en la plataforma.
Recomendación de Heartscale: lleve Bolt Database con Claim, nunca con el botón Connect, y borre el proyecto en Bolt solo después de revisar los datos en la cuenta nueva. Si la app tiene usuarios reales, login o funciones de servidor, pida una revisión de las reglas de acceso de la base antes de cambiar el dominio.
Antes de empezar: qué es suyo y qué queda en Bolt
El centro de ayuda de Bolt dice que todo el código creado con Bolt y StackBlitz es suyo, también para uso comercial (Corporate and commercial). El código sale completo. Lo demás depende de dónde lo guarda el proyecto:
| Parte | Dónde está | Cómo sale |
|---|---|---|
| Código | En el proyecto de Bolt | Download (.zip) o GitHub |
| Base de datos | Bolt Database (Bolt Cloud) o un Supabase conectado | Claim a Supabase o exportación de tablas |
| Secretos | Pestaña Secrets de la base | Se recrean a mano |
| Sitio publicado | bolt.host o Netlify |
Nuevo deploy en su servidor |
| Dominio | Su registrador o comprado en Bolt | Cambio de DNS o transferencia |
Lo primero es saber qué base usa el proyecto. Haga clic en el ícono de base de datos, arriba al centro de la pantalla. Bolt Cloud crea una base por su cuenta cuando el proyecto la necesita (Bolt Cloud). Si el proyecto se conectó a un Supabase suyo, la base ya está en su cuenta y la migración se reduce mucho.
Paso 1: obtenga el código
La documentación oficial ofrece dos caminos.
Descarga del .zip (Manage your projects):
- Abra el proyecto en Bolt.
- Haga clic en el título del proyecto, arriba a la izquierda, y luego en Download.
- Descomprima el archivo.
- Con Node.js instalado, ejecute en la carpeta del proyecto:
npm install && npm run dev
GitHub (GitHub for version control):
- En el proyecto, haga clic en el ícono de GitHub, arriba a la derecha, y en Log in to GitHub.
- Haga clic en Authorize y en Install the GitHub App. Elija All repositories u Only select repositories y confirme con Install & Authorize.
- Vuelva a hacer clic en el ícono de GitHub, ponga un nombre al repositorio y haga clic en Create repository.
El repositorio nace privado, en la rama main. Bolt sincroniza en los dos sentidos: hace un commit por cada cambio que no rompe el proyecto y trae los cambios de GitHub cada 30 segundos. Solo el dueño del proyecto conecta y administra la integración.
Prefiera GitHub. Guarda el historial y permite que el servidor nuevo haga deploy con cada push. Dos advertencias de la documentación: si Bolt y GitHub cambian casi al mismo tiempo, Bolt sobrescribe la versión de GitHub. Y desconectar el proyecto de GitHub es definitivo; para reconectar el mismo repositorio hay que pedirlo al soporte.
Paso 2: lleve la base de datos
El camino cambia según la base.
Si el proyecto usa Bolt Database
La página de la base dice que hoy no hay una forma soportada de migrar una Bolt Database existente a Supabase (Database). El botón Connect reemplaza la conexión y puede causar pérdida de datos (Advanced database settings).
La salida que Bolt indica para conservar los datos es Claim, que pasa la base a su cuenta de Supabase (Supabase for databases):
- Confirme que Bolt está conectado a su cuenta de Supabase.
- Abra el proyecto y haga clic en el ícono de base de datos, arriba al centro.
- Abra la pestaña Advanced y haga clic en Claim.
- Termine los pasos en Supabase.
Después, la base aparece como un proyecto en la página Projects de Supabase. Claim exige plan Pro o Teams en Bolt, y usted debe ser dueño de la organización en Supabase.
Sin Claim, queda exportar los datos tabla por tabla (Database tables): ícono de base, abra la tabla, marque la casilla del encabezado para seleccionar todas las filas, haga clic en Export y elija CSV o JSON. Eso lleva las filas, pero no la estructura completa de la base. Use Claim siempre que su plan lo permita.
Si el proyecto ya usa un Supabase suyo
La base ya está en su cuenta y sigue allí. Al borrar un proyecto, Bolt no borra recursos externos como un Supabase (Manage your projects). Solo falta apuntar la app nueva a esa base.
Después del Claim
La base pasa a ser suya para mantener y proteger. Revise las reglas de acceso de las tablas antes de abrir la app al público. Nuestra guía para configurar RLS en Supabase muestra cómo comprobarlas. En nuestras revisiones, abrimos cada tabla que llegó con el Claim, comprobamos que RLS esté activo y vemos qué deja leer y grabar cada política a un visitante anónimo y a un usuario con sesión iniciada.
Paso 3: recree secretos y variables
Los secretos de Bolt están en ícono de base → Secrets, y las funciones de servidor los leen (Database secrets settings). La propia documentación pide no guardarlos nunca como texto en el código. Anote el nombre de cada secreto y recree los valores en el servidor nuevo.
Si la app está hecha con Vite, importa una regla de Vite: las variables con prefijo VITE_ entran en el código del navegador al hacer el build y no deben guardar claves secretas (Env Variables and Modes). ¿Cambió una? Vuelva a hacer el build. Busque en el código dónde la app lee la URL y la clave de la base, y confirme que apuntan al proyecto correcto de Supabase.
Paso 4: haga el build y aloje la app
Abra el package.json y revise los scripts. En un proyecto Vite, npm run build genera los archivos en la carpeta dist/ (Deploying a Static Site). vite preview sirve para probar en local, no para producción.
npm ci
npm run build
# salida en dist/
En un VPS con Nginx, copie dist/ y envíe todas las rutas a index.html:
location / {
try_files $uri $uri/ /index.html;
}
Después, active HTTPS. Si prefiere un panel, Coolify se instala en un VPS Linux con al menos 2 núcleos y 2 GB de RAM y hace deploy desde GitHub.
Si la app tiene lógica de servidor, necesita un lugar donde correr. Después del Claim, compruebe en Supabase que las funciones de servidor estén allí: la documentación de Bolt no detalla qué lleva el Claim además de la base. Una nota de la página de Netlify en Bolt: esa integración aloja sitios solo de navegador, sin base de datos ni backend (Netlify for hosting).
Paso 5: pruebe antes del cambio
Corra la app nueva en una dirección provisional y verifique:
- Abra una ruta interna directo por la URL y recargue. Un 404 indica que falta el fallback a
index.html. - Inicie y cierre sesión. Un error de redirección suele ser la URL nueva que falta en la lista de retornos del login en Supabase.
- Lea, grabe y suba un archivo.
- Llame a cada función de servidor y confirme que encuentra sus secretos.
Paso 6: mueva el dominio
Dominio de otro registrador. En Bolt, apunta a site-dns.bolt.host (Connect your domain). Para liberarlo: ícono de engranaje → All project settings → Domains & Hosting, los tres puntos en la fila del dominio → Remove domain. Luego cambie los registros en su proveedor de DNS para el servidor nuevo.
Dominio comprado en Bolt. La transferencia a otro registrador se habilita 60 días después de la compra. Durante el bloqueo, Bolt permite mover el dominio a una cuenta de Name.com a su nombre (Purchase a domain). La renovación automática está en Settings → Cloud.
Paso 7: cierre en Bolt
- Para bajar el sitio de
bolt.host, desconecte su dominio propio y use Publish → Unpublish (Publish your project). - No borre el proyecto antes de revisar la base nueva. Borrar elimina para siempre los archivos, el historial del chat y la Bolt Database, sin vuelta atrás (Manage your projects).
- No use una copia del proyecto como respaldo de la base: al duplicar, la Bolt Database copia la estructura, pero no los datos.
Cuánto tiempo lleva
Un sitio sin base de datos es el caso simple: pasos 1, 4, 5 y 6. Con Bolt Database, el Claim marca el ritmo. Con login, archivos y funciones de servidor, el paso 5 pide más cuidado. La misma lógica vale para otras plataformas, como mostramos en la guía cómo salir de Lovable. Vea también el servicio de migración de plataforma.
¿Hacerlo usted mismo o contratar?
Esta guía basta cuando la app es simple; la tabla muestra cuándo conviene tener un equipo al lado.
| Situación | Camino |
|---|---|
Sitio sin base de datos, o base ya en un Supabase suyo, y alguien en el equipo que ejecuta npm run build |
Hágalo usted mismo con esta guía |
| Bolt Database con datos de usuarios reales | Llame a un equipo para hacer el Claim y revisar los datos antes de borrar el proyecto |
| Login, pagos o datos personales en la app | Solicite el diagnóstico de Heartscale antes del cambio: base, secretos, funciones de servidor y reglas de acceso |
| Plazo corto o nadie técnico en el equipo | Contrate la migración con precio cerrado |
Solicite un diagnóstico de Heartscale
Nuestro equipo mapea lo que su app usa de Bolt: base de datos, secretos, funciones de servidor y dominio. Revisamos las reglas de acceso de la base que pasa a su cuenta y entregamos el plan de migración con precio cerrado.
El diagnóstico, a precio de lanzamiento, cuesta US$ 19 (antes US$ 79) y se descuenta si contrata la migración. Solo trabajamos en apps de quien demuestra ser su dueño.