Bolt.new error while syncing with GitHub: solución

El mensaje “error while syncing with GitHub” en Bolt.new significa que Bolt no pudo enviar o traer cambios de tu repositorio. Casi siempre es por permisos de la GitHub App de Bolt (perdió acceso al repo), por un conflicto (GitHub tiene una versión más nueva que Bolt) o por una falla temporal de Bolt. Antes de tocar nada, descarga una copia de tu proyecto para no perder trabajo.

Paso 0: respalda tu proyecto

Descarga el proyecto desde Bolt (opción de exportar o descargar). Si algo sale mal mientras arreglas la sincronización, tendrás tu código.

Paso 1: revisa si Bolt tiene un incidente

Entra a status.bolt.new. Bolt ha tenido incidentes en que los proyectos parecían desconectados de GitHub en la interfaz aunque la sincronización seguía funcionando. Si hay un incidente activo, espera a que lo resuelvan.

Paso 2: revisa el estado de sincronización

Abre tu proyecto y da clic en el ícono de GitHub (esquina superior derecha). Según la documentación de Bolt sobre Git, ahí ves:

• “Syncing to GitHub” o “Synced to GitHub”.
• El repositorio vinculado.
• La rama actual.

Si dice Synced pero tus cambios no aparecen en GitHub, pasa al paso 3.

Paso 3: vuelve a autorizar la GitHub App

Es la solución más común.

1. Ve a la página de inicio de Bolt y da clic en GitHub (debajo del chat).
2. Elige Configure the GitHub App.
3. Selecciona tu cuenta (o la organización dueña del repo).
4. Verifica que el repositorio esté incluido: All repositories o, en Only select repositories, que esté marcado.
5. Da clic en Install & Authorize y sigue los pasos.

También puedes revisarlo desde GitHub: Settings → Applications → Installed GitHub Apps, abre la app de Bolt y confirma a qué repositorios tiene acceso.

Si el repositorio es de una organización

Los administradores de la organización deciden qué repositorios ve Bolt. Si cambiaron permisos o eliminaron la app de la organización, la sincronización falla. Pide al administrador que revise la instalación de la app en la organización.

Paso 4: resuelve conflictos

Un conflicto ocurre cuando GitHub tiene cambios que Bolt no tiene (por ejemplo, alguien hizo un commit directo en GitHub o editaste el código en tu computadora). Bolt revisa cambios externos periódicamente; cuando detecta uno, trae la versión de GitHub y te deja elegir:

• Pull and resend last message: trae lo de GitHub y vuelve a aplicar tu último prompt.
• Pull and discard last message: trae lo de GitHub y descarta tu último prompt.

Si trabajas en dos lugares a la vez (Bolt y tu editor), haz siempre git pull antes de editar localmente y espera a que Bolt diga Synced antes de volver a pedirle cambios.

git pull origin main
# haz tus cambios
git add -A
git commit -m "ajuste manual"
git push origin main

Paso 5: revisa la rama

Bolt trabaja sobre una rama activa. Si cambiaste de rama en GitHub, la borraste o la renombraste, Bolt puede fallar al sincronizar. Desde el ícono de GitHub puedes cambiar de rama o crear una nueva. Los merges se hacen en GitHub, no en Bolt.

Casos especiales

El repositorio se borró o se movió. Si borraste el repo, Bolt no tiene a dónde sincronizar. Crea uno nuevo desde el proyecto (ícono de GitHub → Create repository).

Desconectaste el proyecto. La documentación de Bolt indica que desconectar es permanente: no puedes reconectar manualmente al mismo repo; hay que contactar a soporte. Como alternativa, importa el repo como proyecto nuevo desde la página de inicio (GitHub → Import from URL). Para importar necesitas permisos de push, que el repo tenga rama por defecto y que no esté vacío.

No eres el dueño del proyecto. Solo el dueño puede conectar o administrar la integración. Los cambios de colaboradores se sincronizan cuando el dueño abre el proyecto.

Error 500 al importar. Si al importar un repo ves un 500, revisa también Bolt.new error 500.

Errores comunes

• Editar al mismo tiempo en Bolt y en tu computadora sin hacer pull.
• Usar una cuenta de GitHub distinta a la que autorizó la app.
• Quitarle a la app el acceso “a todos los repositorios” y olvidar agregar el nuevo.
• Renombrar la rama main sin avisarle a Bolt.

Cómo confirmar que tu código sí quedó en GitHub

Que Bolt diga Synced es buena señal, pero vale la pena comprobarlo directo en GitHub, sobre todo después de un error:

1. Abre tu repositorio en github.com y revisa que estés en la rama correcta (el selector de ramas arriba a la izquierda).
2. Entra a Commits y mira la fecha y el mensaje del último. Debe coincidir con tu último cambio en Bolt.
3. Abre uno o dos archivos que sabes que cambiaste y confirma que tengan el contenido nuevo.
4. Si usas Vercel o Netlify conectados al repo, revisa que el último despliegue corresponda a ese commit.

Si el último commit es de hace días, la sincronización no está funcionando aunque la interfaz diga lo contrario. Vuelve al paso 3 (reautorizar la app) y, si no se arregla, descarga el proyecto y súbelo tú.

Subir los cambios a mano mientras se arregla

Si necesitas que tu código esté en GitHub hoy y Bolt no sincroniza, puedes descargarlo y subirlo tú desde tu computadora:

# dentro de la carpeta del proyecto descargado
git init
git remote add origin https://github.com/tu-usuario/tu-repo.git
git fetch origin
git checkout -b respaldo-bolt
git add -A
git commit -m "respaldo manual desde Bolt"
git push origin respaldo-bolt

Súbelo a una rama nueva, no encima de main, para no pisar lo que ya había. Después comparas y combinas en GitHub con un pull request. Si nunca has usado Git, este es un buen momento para pedir ayuda: un push --force mal dado puede borrar el historial.

Por qué vale la pena tener GitHub bien conectado

GitHub es tu respaldo y tu historial: si la IA rompe algo, puedes volver atrás, y si después quieres publicar en Vercel o Netlify, ambos se conectan al repositorio. Lo explicamos en publicar tu proyecto de Bolt en Netlify o Vercel. Si usas también Lovable, el proceso equivalente está en conectar Lovable a GitHub.

Si la sincronización sigue fallando y tienes miedo de perder trabajo, en Black Engine revisamos tu proyecto de Bolt y tu repositorio contigo por WhatsApp para dejar todo sincronizado y respaldado.