Conectar Lovable a GitHub: paso a paso y cómo funciona

Para conectar Lovable a GitHub ve a Project settings → Git → GitHub, autoriza la app de Lovable en tu cuenta de GitHub y da clic en Connect. Lovable crea un repositorio privado nuevo y, desde ese momento, sincroniza en dos sentidos: lo que cambias en Lovable se sube a GitHub y lo que subes a GitHub aparece en Lovable. Según la documentación de Lovable, está disponible en todos los planes para github.com.

GitHub es un servicio donde se guarda el código con todo su historial de cambios. Conectarlo te da respaldo, te permite volver a versiones anteriores y es el paso previo para publicar en Vercel o Netlify o para que un programador trabaje en tu proyecto.

Paso a paso: conectar Lovable a GitHub

1. Agrega la conexión con GitHub

1. Ve a Workspace settings → Git → GitHub → Add connection (o desde Project settings → Git → GitHub → Add connection).
2. Da clic en Add account. Se abre GitHub.
3. Elige tu cuenta personal o la organización donde quieres el repositorio.
4. Elige All repositories o Only select repositories.
5. Da clic en Install & Authorize.

Esta conexión queda guardada en el workspace para usarla en otros proyectos.

2. Conecta el proyecto

1. Abre el proyecto y ve a Project settings → Git → GitHub.
2. Junto a la conexión del workspace, da clic en Connect.
3. Lovable crea un repositorio privado nuevo y empieza la sincronización.

3. Comprueba que funcionó

Abre el repositorio en GitHub. Deberías ver los archivos de tu proyecto (src/, package.json, etc.) y commits recientes. Haz un cambio pequeño en Lovable (un texto) y verifica que aparezca un commit nuevo en GitHub.

Los nombres de los menús pueden cambiar con nuevas versiones de Lovable; si no los encuentras, revisa la documentación vigente.

Cómo funciona la sincronización (lovable github sync)

• Dos sentidos. Lovable sube sus cambios a GitHub y trae lo que subas a la rama activa.
• Una rama a la vez. Por defecto es la rama principal del repo (normalmente main). Puedes cambiar de rama con el selector. Una rama nueva se crea a partir de la rama activa, no necesariamente de main.
• Repositorio nuevo siempre. No puedes conectar un repo que ya existe. Si desconectas y vuelves a conectar, se crea otro repositorio.

Trabajar desde tu computadora

git clone https://github.com/tu-usuario/tu-proyecto.git
cd tu-proyecto
npm install
npm run dev

Después de cambiar algo:

git pull            # trae lo último que hizo Lovable
git add -A
git commit -m "ajuste en el formulario"
git push            # Lovable lo recibe en la rama activa

Haz siempre git pull antes de editar, para no chocar con cambios recientes de Lovable.

Qué rompe la integración (y qué no)

Según la documentación de Lovable:

Acción	¿Se rompe la sincronización?
Renombrar el repositorio, tu usuario u organización	No
Transferir el repositorio a otro dueño	Solo sigue si tu workspace tiene conexión con el nuevo dueño
Borrar el repositorio	Sí
Desconectar el proyecto	Al reconectar se crea un repo nuevo

Además, la app de Lovable solo se puede instalar una vez por cuenta u organización de GitHub.

Lovable GitHub integration: permisos y planes

• github.com: todos los planes.
• GitHub Enterprise (residencia de datos o Server): solo plan Enterprise.
• Quién puede conectar: dueños o administradores del workspace manejan las conexiones; dueños o administradores del proyecto conectan y desconectan proyectos.

Para qué te sirve tenerlo en GitHub

1. Respaldo e historial. Si la IA rompe algo, puedes ver qué cambió y regresar.
2. Publicar en otro hosting. Vercel y Netlify se conectan al repositorio. Ver subir tu página a Vercel.
3. Trabajar con un programador sin darle tu cuenta de Lovable.
4. Llevarte el proyecto. Ver exportar un proyecto de Lovable.

Errores comunes

• Hacer el repositorio público sin revisar que no haya llaves en el código. Antes, revisa qué es el archivo .env.
• Editar en Lovable y en tu computadora al mismo tiempo sin git pull.
• Borrar el repositorio “para empezar limpio” y perder la sincronización.
• Hacer force push desde tu computadora y borrar cambios de Lovable.
• Trabajar en una rama en tu computadora mientras Lovable edita otra, y no saber cuál está activa.

Casos frecuentes después de conectar

“No aparece el botón Connect”

Casi siempre es un tema de permisos. Revisa que seas dueño o administrador del proyecto y que la conexión del workspace exista. Si el repositorio va a vivir en una organización de GitHub y tú no eres dueño de esa organización, la instalación de la app de Lovable puede quedar como solicitud pendiente hasta que un dueño la apruebe.

“Subí cambios a GitHub y Lovable no los muestra”

Verifica tres cosas, en este orden:

1. Que hiciste git push a la rama activa en Lovable, no a otra.
2. Que el commit realmente llegó a GitHub (ábrelo en la web del repositorio).
3. Que no hay un error de compilación: si tu cambio rompe el build, la vista previa de Lovable puede mostrar error aunque el código sí se haya sincronizado.

“Quiero que otra persona trabaje en el código”

Agrégala como colaboradora del repositorio en GitHub (Settings → Collaborators) en lugar de compartir tu cuenta de Lovable. Pídele que trabaje en una rama propia y que la una a la rama activa solo cuando el cambio esté probado. Así cada cambio queda registrado con su autor y puedes revertirlo si algo falla.

“Ya tengo el código en otro repositorio”

Como Lovable no se conecta a repos existentes, lo práctico es decidir cuál es la fuente principal. Si el proyecto ya creció fuera de Lovable y lo mantiene un programador, muchas veces conviene dejar Lovable solo para prototipos y trabajar el repositorio con herramientas normales de desarrollo.

Qué revisar antes de dar acceso al repositorio

• Que no haya llaves privadas en el historial de commits, no solo en la versión actual: borrar un archivo no lo quita del historial.
• Que la service_role de Supabase nunca esté en el código del frontend. Si ya pasó, sigue los pasos de service role key expuesta.
• Que el repositorio siga siendo privado salvo que tengas una razón para abrirlo.

Si usas Bolt, el proceso es distinto; lo explicamos en Bolt.new error while syncing with GitHub. Y si quieres conectar tu proyecto de Lovable a GitHub para que alguien lo revise o lo termine, en Black Engine te ayudamos a dejarlo bien configurado por WhatsApp.