Integraciones
GitHub
Envía el código de tu app a un repositorio privado de tu propia cuenta de GitHub, sube versiones nuevas cuando quieras y entrégale el código a un desarrollador.
El código de tu app es tuyo. Con GitHub puedes guardar una copia en un repositorio privado de tu propia cuenta de GitHub, enviar allí versiones más nuevas cuando quieras y compartirlo con un desarrollador. La exportación a GitHub está incluida en todos los planes y no gasta créditos.
Cómo funciona la sincronización con GitHub
| Lo que haces | Lo que pasa |
|---|---|
| Envías tu proyecto por primera vez | Buildliy crea un repositorio privado en tu cuenta de GitHub, con el nombre de tu proyecto (por ejemplo buildliy-candle-shop, o buildliy-candle-shop-2 si ese nombre ya está en uso), y sube tu última versión con un README |
| Sigues construyendo en Buildliy | No se envía nada automáticamente. Un puntito en el icono de GitHub te avisa de que hay versiones más nuevas que GitHub todavía no tiene |
| Eliges Subir última versión | Tu versión más reciente llega al repositorio como un commit nuevo |
| Alguien editó el repositorio en GitHub | Buildliy no sobrescribe su trabajo. Tu actualización llega como una solicitud de cambios (pull request) que puedes revisar y fusionar en GitHub |
Los cambios hechos en GitHub se quedan en GitHub. No vuelven a tu proyecto de Buildliy ni a su vista previa.
Conecta GitHub y crea tu repositorio
Haz clic en el icono de GitHub
Abre tu proyecto y haz clic en el icono de GitHub que está junto a Publicar, arriba a la derecha. Si todavía no has conectado GitHub, este paso te lleva a GitHub.
Aprueba en GitHub
Inicia sesión en GitHub si hace falta y aprueba a Buildliy. GitHub te muestra lo que Buildliy pide: acceso completo a tus repositorios, públicos y privados, que necesita para crear y actualizar el repositorio de tu proyecto, y acceso de solo lectura a tu perfil. Vuelves a tu proyecto y ves "GitHub conectado: ya puedes enviar este proyecto a GitHub."
Crea el repositorio
Haz clic otra vez en el icono de GitHub y elige Crear repositorio privado. Necesitas al menos una construcción terminada; mientras tanto verás Crea tu app primero. Cuando termina, ves "Enviado a GitHub" con el nombre del repositorio y un botón Abrir.
También puedes hacer clic en Respaldar en GitHub dentro de Gestionar → Resumen (en Asistentes mágicos, cuando el backend de tu app ya está listo). Hace lo mismo: crea el repositorio la primera vez y lo actualiza después. Antes, conecta GitHub con el icono de GitHub.
Envía versiones más nuevas
Haz clic en el icono de GitHub para abrir su menú:
- Subir última versión envía tu versión más reciente. El menú muestra Cambios nuevos cuando hay algo que enviar, o Al día cuando no.
- Abrir repositorio abre el repositorio en GitHub.
- Desconectar GitHub quita el acceso de Buildliy (mira más abajo).
Después de subir una versión, verás uno de estos mensajes:
- "Subimos tu última versión a…": el repositorio ya coincide con tu app.
- "…ya tiene tu última versión.": no había nada nuevo que enviar.
- "Abrimos una solicitud de cambios (pull request) en GitHub": el repositorio tenía cambios hechos en GitHub, así que tu actualización fue a una solicitud de cambios. Haz clic en Revisar y luego fusiónala en GitHub para poner el repositorio al día.
Qué hay en el repositorio
- Todos los archivos de tu app, incluidas sus imágenes, con los mismos pequeños ajustes de seguridad que Buildliy hace cuando publicas (por ejemplo, el ayudante del constructor para editar la vista previa se deja fuera).
- Un README con el nombre y la descripción de tu app, su dirección en línea si está publicada, cómo ejecutarla en una computadora (Node.js 20 o más reciente, y luego
npm installynpm run dev), los ajustes que necesita y un enlace de vuelta a tu proyecto de Buildliy. - Un archivo
.env.example, cuando tu app lee algún ajuste (variables de entorno), con sus nombres y algunas notas. Nunca contiene los valores.
Algunas cosas nunca están en el repositorio:
- Secretos. Buildliy no sube código que contenga algo que parezca una clave secreta. Si encuentra una, te dice en qué archivo está y te pide que muevas la clave a Gestionar → Secretos (o que se lo pidas a la IA) antes de volver a intentarlo. Las claves guardadas como secretos o conectores se quedan en Buildliy. Mira Secretos y claves de API.
- Los datos de tu app. Las tablas y todo lo que hay guardado en ellas se quedan en la base de datos de tu app. Si lo conectas a una base de datos nueva, el código empieza vacío.
- La clave privada de Buildliy de tu app. Las funciones integradas, como la IA en tu app y los pagos, la usan. Se configura sola cuando tu app se ejecuta en Buildliy; si el código se ejecuta en otro lugar, esas funciones no funcionarán sin ella.
Si Buildliy no puede actualizar tu repositorio
Si el repositorio se eliminó o se archivó, pertenece a una cuenta de GitHub distinta de la que conectaste, o tu cuenta no tiene permiso para subir cambios, Buildliy muestra No se puede actualizar con el nombre del repositorio y el motivo. Elige Crear un repositorio nuevo para enviar tu última versión a un repositorio privado nuevo. El anterior no se modifica ni se elimina.
Trabaja con un desarrollador
Dale acceso en GitHub
Invita al desarrollador al repositorio desde la configuración de GitHub. Tu repositorio es privado, así que solo lo pueden ver las personas que invites.
Pídele que siga el README
El README explica cómo ejecutar la app en local y qué ajustes hay que completar. Tu desarrollador copia
.env.examplea.env.localy agrega sus propios valores.Acuerden dónde se hacen los cambios
Buildliy no trae de vuelta a tu proyecto los cambios hechos en GitHub. Si sigues construyendo en Buildliy mientras un desarrollador edita en GitHub, cada versión que subas llegará como una solicitud de cambios (pull request) que él puede fusionar junto con su trabajo.
¿Prefieres no usar GitHub? Puedes descargar todo el código en un ZIP desde la pestaña Código. Consulta Mira y descarga tu código.
En un espacio de trabajo compartido, solo el propietario del espacio puede enviar un proyecto a GitHub, porque el código va a su cuenta de GitHub. Los integrantes del equipo pueden abrir un repositorio vinculado desde el icono de GitHub, pero GitHub solo se lo muestra a las personas a las que el propietario les haya dado acceso en GitHub.
Desconectar GitHub
Haz clic en el icono de GitHub, elige Desconectar GitHub y confirma. Buildliy deja de tener acceso a tu cuenta de GitHub en todos los proyectos, y se revoca el acceso que tenía. Tus repositorios y su código se quedan en GitHub, y cada proyecto sigue vinculado a su repositorio. Hasta que vuelvas a conectar, el menú de GitHub de un proyecto vinculado muestra Conecta GitHub para subir. Puedes volver a conectar cuando quieras, incluso con otra cuenta de GitHub.
Relacionado
¿Sigues con dudas? Lee las preguntas frecuentes o escríbenos.