>_ Black Engine

Exportar proyecto Lovable: cómo sacar tu código paso a paso

Por Black Engine · 6 de noviembre de 2026

Para exportar un proyecto de Lovable necesitas conectarlo a GitHub: Lovable crea un repositorio con todo tu código y, desde ahí, lo descargas en ZIP o lo clonas a tu computadora. Es gratis, toma unos minutos y es lo primero que deberías hacer si quieres tener una copia de tu app, llevarla a otro hosting o pasársela a un programador.

GitHub es, en pocas palabras, un sitio donde se guarda código con historial de cambios. Si nunca lo has usado, solo necesitas crear una cuenta gratuita en github.com.

Cómo exportar tu proyecto de Lovable a GitHub

Estos pasos siguen la documentación oficial de la integración con GitHub a noviembre de 2026. Los nombres de los menús pueden cambiar con las actualizaciones de Lovable.

  1. Entra a tu proyecto en Lovable.
  2. Abre Project settings → Git → GitHub (también existe la ruta Workspace settings → Git → GitHub → Add connection).
  3. Da clic en Add account. Se abre una ventana de GitHub.
  4. Elige tu cuenta u organización, decide si Lovable tendrá acceso a All repositories o Only select repositories, y da clic en Install & Authorize.
  5. De regreso en Lovable, junto a la conexión que acabas de crear, da clic en Connect.
  6. Lovable crea un repositorio privado nuevo y empieza la sincronización en dos sentidos.

Si quieres el detalle de la conexión y sus problemas típicos, tenemos una guía específica para conectar Lovable a GitHub.

Descargar el código a tu computadora

Ya con el repositorio creado tienes dos opciones:

  • Sin instalar nada: entra al repositorio en github.com, da clic en el botón verde Code y luego en Download ZIP.
  • Con Git (si tú o tu programador lo usan):
git clone https://github.com/tu-usuario/tu-proyecto.git
cd tu-proyecto
npm install
npm run dev

npm install descarga las librerías que usa tu app y npm run dev la levanta en tu computadora para probarla. Necesitas tener instalado Node.js.

Qué incluye y qué NO incluye la exportación

Este es el punto donde más gente se confunde. La guía de Lovable sobre self-hosting aclara que la sincronización y la descarga incluyen el código y los archivos de migración de la base de datos, pero no el contenido.

Viene en la exportación NO viene en la exportación
Todo el código (páginas, componentes, estilos) Los datos de tus tablas (clientes, pedidos, etc.)
Archivos de migración en supabase/migrations/ Los archivos que tus usuarios subieron (fotos, PDFs)
Configuración del proyecto (package.json, etc.) Llaves secretas y API keys
Historial de cambios en Git Usuarios registrados y sus contraseñas

Las “migraciones” son archivos SQL que describen cómo está armada tu base de datos (qué tablas y columnas tiene). Con ellas puedes recrear la estructura en otro lado, pero vacía. Para llevarte los datos tienes que exportarlos aparte; lo explicamos en cómo migrar de Lovable Cloud a Supabase.

Las llaves (de Stripe, Resend, OpenAI, etc.) tampoco viajan, y está bien que así sea. Vas a tener que volver a capturarlas en el nuevo hosting como variables de entorno. Si no sabes qué es eso, revisa qué es un archivo .env.

Lovable GitHub import: subir un repositorio existente a Lovable

La búsqueda “lovable github import” suele venir de dos situaciones: tienes código hecho en otra herramienta (Bolt, Cursor, un programador) y quieres seguir editándolo con Lovable, o desconectaste GitHub y quieres volver a ligar el repositorio anterior.

Lo que dice la documentación a noviembre de 2026:

  • La sincronización de Git siempre crea un repositorio nuevo; no puede ligarse a uno que ya existe.
  • Si desconectas y vuelves a conectar, también se crea un repositorio nuevo.
  • Para importar código existente: descarga el repositorio en ZIP, crea un proyecto nuevo en Lovable con la opción Upload code y, si quieres sincronización continua, conecta GitHub a ese proyecto nuevo.

Ten en cuenta que Lovable trabaja mejor con proyectos del tipo que él mismo genera (React con Vite o TanStack Start). Si subes un proyecto con otra estructura, puede funcionar a medias.

Cómo funciona la sincronización después de exportar

  • Lo que cambias en Lovable se sube a GitHub.
  • Lo que alguien sube (hace “push”) a la rama activa en GitHub se refleja en Lovable.
  • Lovable edita una sola rama a la vez, normalmente main.
  • GitHub rechaza archivos de más de 100 MB y Lovable no guarda archivos de más de 10 MB, así que no subas videos pesados al código.

Esto permite que un programador trabaje en el código con sus herramientas mientras tú sigues usando Lovable, siempre que se pongan de acuerdo para no editar lo mismo al mismo tiempo.

Errores comunes al exportar un proyecto de Lovable

  • Creer que el ZIP es un respaldo completo. Si tu app tiene usuarios o datos, el ZIP solo trae el código. Respalda la base de datos por separado.
  • Dar acceso a todos tus repositorios sin necesidad. Elige Only select repositories si tienes otros proyectos privados.
  • Subir llaves al código. Si alguna vez pegaste una API key directo en un archivo, ahora está en el historial de GitHub. Cámbiala (rótala) en el servicio correspondiente, aunque el repositorio sea privado.
  • Desconectar y reconectar para “arreglar” algo. Cada reconexión crea un repositorio nuevo, y terminas con varios repositorios desordenados.
  • Esperar que corra igual en cualquier hosting. Los proyectos nuevos con TanStack Start ejecutan código de servidor y no funcionan en un hosting de archivos estáticos. Antes de mover tu app, revisa cómo subir tu página web a Vercel, que sí soporta ese tipo de proyectos.

Cuándo pedir ayuda

Exportar el código lo puedes hacer tú solo en cinco minutos. Lo delicado viene después: mover la base de datos sin perder usuarios, reconfigurar el inicio de sesión, los pagos y las llaves, y dejar la app corriendo en otro lado. Si tu app ya tiene clientes reales, conviene que alguien con experiencia lo planee contigo. En Black Engine lo revisamos por WhatsApp y te decimos qué implica en tu caso.

Preguntas frecuentes

¿Puedo exportar mi proyecto de Lovable si estoy en el plan gratis?

Sí. Según la documentación de Lovable, la sincronización con github.com está disponible en todos los planes. Desde GitHub puedes descargar el código en ZIP o clonarlo cuando quieras.

¿Al exportar se van también mis usuarios y los datos de la base de datos?

No. La exportación incluye el código fuente y los archivos de migración de la base de datos, pero no el contenido de las tablas, los archivos subidos ni las llaves secretas. Eso se exporta aparte.

¿Puedo importar un repositorio de GitHub que ya tengo a Lovable?

No con la sincronización normal, porque siempre crea un repositorio nuevo. Lovable indica descargar tu repositorio en ZIP y subirlo a un proyecto nuevo con la opción Upload code; después puedes conectar GitHub a ese proyecto.

¿Si exporto mi proyecto, deja de funcionar en Lovable?

No. Exportar es hacer una copia. Tu proyecto sigue en Lovable y, con la sincronización activa, los cambios se reflejan en ambos lados.

Pide ayuda por WhatsApp