--- title: "Guarda el código de tu sitio en GitHub | Briks" url: https://briks.dev/es/docs/github description: "Conecta un repositorio de GitHub: cada versión que publiques se sube allí y cada push a su rama se revisa y se publica en tu sitio." last_updated: 2026-10-08 --- # 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 lectura Comprobado 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](https://briks.dev/es/docs/code) 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. | Carpeta | Qué 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 Dónde 1. Projects 2. Your project 3. Settings 4. GitHub 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. Quién puede conectar La sincronización con GitHub viene con los planes de pago. Solo los Owners y Admins del espacio de trabajo pueden conectar, desconectar o resolver un conflicto; todos los que pueden ver el proyecto ven la conexión y su registro de sincronización. Cada rama guarda el código de un solo proyecto, así que da a cada sitio su propia rama o repositorio. ## 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](https://briks.dev/es/docs/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 push | Qué 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 texto | Se rechaza. Añádelas a través de la [biblioteca de medios](https://briks.dev/es/docs/media-library). Eliminar una sí se puede. | | Cualquier otra cosa, como archivos de configuración, archivos `.env` o un archivo con forma de clave | Rechazado, 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](https://briks.dev/es/docs/telegram) y [Discord](https://briks.dev/es/docs/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. ## Sigue leyendo - [Trabajar en un proyecto **El código de tu sitio** Explora, edita y publica tu código en File Explorer en todos los planes. Con un plan de pago, descarga cualquier versión en zip y mira qué deja fuera.](https://briks.dev/es/docs/code) - [Datos y automatización **Secretos** Guarda en el servidor las claves de API y contraseñas de tu sitio, nunca en páginas ni descargas. Añádelas, cámbialas, quítalas y conoce las reglas de Briks.](https://briks.dev/es/docs/secrets) - [Trabajar en un proyecto **Versiones, deshacer y rehacer** Cada construcción y cambio se guarda como versión de tu sitio. Deshaz, rehaz o pon en vivo cualquier versión anterior tal como estaba, sin retener créditos.](https://briks.dev/es/docs/versions) - [Espacios de trabajo y cuenta **Miembros y roles** Invita por enlace de correo y asigna a cada persona un rol: Owner, Admin, Editor o Viewer. Mira qué permite cada rol y cuántas personas admite cada plan.](https://briks.dev/es/docs/members-and-roles) ¿Sigues atascado? Escribe a [hello@briks.dev](mailto:hello@briks.dev) con el nombre de tu proyecto y lo que esperabas ver. Una captura de pantalla ayuda.