Guarda el código de tu sitio en GitHub

GitHub sync guarda el código propio de tu sitio en un repositorio de GitHub, sincronizado en ambos sentidos. Cada versión que se publica se convierte en un commit allí, y un push a la rama conectada se revisa, se compila y se publica en tu sitio.

5 minutos de lecturaComprobado con el estudio el 8 de octubre de 2026

Qué se envía a GitHub

Solo los archivos propios de tu sitio: los que muestra el Explorador de archivos y los que incluye su descarga. Las partes compartidas sobre las que funciona todo sitio de Briks, los ajustes del sitio, tus claves y los registros de tu base de datos nunca van allí. Por eso el repositorio no se compila ni se ejecuta por sí solo: Briks compila y publica lo que subes.

CarpetaQué incluye
app/Las páginas del sitio.
components/custom/Las secciones escritas para tu sitio.
content/Las palabras y los datos del sitio.
api/El código de servidor propio del sitio, si lo tiene.
db/schema.ts y db/data/La estructura de los datos del sitio y los registros con los que empieza.
public/Las imágenes y los archivos propios del sitio.

Si el repositorio no tiene README, Briks añade uno que explica estas carpetas y cómo funciona la sincronización.

Conecta un repositorio

  1. Pulsa Connect GitHub

    Dónde: Settings, GitHub

    Se abre GitHub. Si la app de Briks aún no está en tu cuenta u organización de GitHub, GitHub te pregunta dónde instalarla y qué repositorios puede usar, y luego te devuelve aquí.

  2. Elige el repositorio y la rama

    Dónde: Settings, GitHub

    Elige la cuenta y luego el repositorio. La rama empieza siendo la predeterminada del repositorio; indica otra si quieres, y una que aún no exista se crea a partir de la rama predeterminada. Create a repository on GitHub abre GitHub para crear uno privado con el nombre de tu sitio. Repository not listed? Give Briks access to it abre los ajustes de la app en GitHub.

  3. Pulsa Connect

    Dónde: Settings, GitHub

    Una rama vacía se conecta al instante. Si la rama ya tiene archivos, Briks primero muestra cuántos son, cuáles están en las carpetas de tu sitio y qué les hace su primer commit. Pulsa Connect and commit this site para continuar, o Choose another.

En un par de minutos, el primer commit trae tu versión en vivo. Reemplaza los archivos de las carpetas de tu sitio por los propios del sitio y elimina los que el sitio no tiene. Todo lo demás del repositorio se queda como está. No se pierde nada de su historial, porque Briks nunca hace force-push.

De Briks a GitHub

  • Cada versión que se publica y cambia los archivos de tu sitio se convierte en un commit en la rama, sin importar cómo se hizo: una compilación, un cambio, un guardado en el File Explorer o en el Visual Editor, o una restauración. Mientras se ejecuta una prueba A/B, sus versiones esperan a que termine.
  • El mensaje del commit es el resumen que lees en el estudio, con el número de la versión y el nombre de quien la pidió.
  • GitHub muestra el estado de cada commit, como Live as version 15.
  • Si un archivo contiene algo con forma de clave o menciona un servicio propio de Briks, no se envía nada y se te indica qué archivo es. Las claves van en Secrets.

De GitHub a Briks

Un push a la rama conectada se publica en tu sitio, sin IA y sin créditos. Primero pasa la misma comprobación de seguridad que un guardado en el File Explorer: se rechaza un script, un frame o un formulario que llegue a otro sitio web, salvo que hayas añadido ese sitio en Settings, Preferences, Allowed websites. Después Briks lo compila y, en uno o dos minutos, el estado del commit dice Live as version 16, o explica por qué no se publicó.

Qué cambia un pushQué ocurre
Archivos en app/, components/custom/, content/, api/, db/schema.ts, db/data/ o public/Publicado en el sitio.
Un README, una licencia y otros archivos en la raíz del repositorio, y .github/Se quedan en GitHub. Nunca forman parte del sitio.
db/migrations/Rechazado. Briks escribe los cambios de los datos a partir de db/schema.ts, así que cambia el esquema en su lugar.
Imágenes y otros archivos que no son textoSe rechaza. Añádelas a través de la biblioteca de medios. Eliminar una sí se puede.
Cualquier otra cosa, como archivos de configuración, archivos .env o un archivo con forma de claveRechazado, con el motivo en el commit. No se publica nada del push.
  • Un push puede cambiar hasta 300 archivos, de hasta 256 KB cada uno y 8 MB en total.
  • Se publican hasta 20 pushes por hora y 100 al día para cada sitio. Un push que supera el límite espera, y su estado en GitHub indica cuándo se publicará. Los pushes que llegan mientras otro espera se publican juntos.
  • Mientras se ejecuta una prueba A/B, un push espera a que termine.

Cuando ambos lados cambiaron el mismo archivo

Un push que llega mientras Briks está publicando espera su turno. Si el push y Briks cambiaron archivos distintos, se conservan ambos. Si cambiaron el mismo archivo de forma distinta, no se publica nada del push: Briks pone su propia versión en una rama llamada briks-sync, y el estado del push indica el archivo. Fusiona briks-sync en GitHub y vuelve a hacer push, o resuélvelo en Settings, GitHub:

  • Use GitHub's version publica todo el push, incluido el archivo que cambiaron ambas partes.
  • Keep Briks's version publica el push sin los archivos que cambiaron ambas partes.

Si se reescribe el historial de la rama, por ejemplo con un force-push, la sincronización se pausa hasta que elijas uno de los mismos dos botones.

Lo que se te avisa

Las sincronizaciones que funcionan son silenciosas, salvo el mensaje de que un push está en vivo. Un push que no se publicó, un push a la espera de una fusión y una conexión que se detuvo aparecen en la campana, y en los chats de Telegram y Discord que tengan activada la alerta Builds finished or failed. Settings, GitHub muestra las últimas 20 sincronizaciones en ambos sentidos, cada una con su commit, sus archivos y su resultado.

Desconectar

  • Disconnect en Settings, GitHub detiene la sincronización en ambos sentidos. El repositorio y su historial quedan exactamente como están.
  • Mover el proyecto a otro espacio de trabajo lo desconecta.
  • Si la app se desinstala en GitHub, o el repositorio se quita de su acceso, la sincronización se detiene y se te avisa.
  • Eliminar el proyecto nunca toca el repositorio.
¿Puedo empezar un proyecto desde un repositorio que ya tengo?

Todavía no. Importar un repositorio existente no está disponible. Crea el sitio en Briks y luego conéctale un repositorio.

¿Puedo ejecutar el repositorio en mi propio equipo?

No. Contiene los archivos propios de tu sitio, no las partes compartidas sobre las que funciona todo sitio de Briks, así que no se compila por sí solo. Haz push de tus cambios y Briks los compila y los publica.

¿Qué puede hacer Briks en mi cuenta de GitHub?

Solo lo que la app pide al instalarla: leer y escribir los archivos de los repositorios que le indiques y establecer el estado de los commits. Escribe únicamente en la rama que conectaste y, cuando ambos lados cambiaron un archivo, en una rama briks-sync.

¿Briks lee mis mensajes de commit?

No. El registro de sincronización muestra el commit de cada push, sus archivos y quién lo hizo, nunca el mensaje.