> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Haz una copia de seguridad de tu proyecto de Macaly y sincronízalo con GitHub

La integración de GitHub de Macaly conecta tu proyecto a un repositorio privado de GitHub. Haz una copia de seguridad de tu código, sincroniza los cambios en ambas direcciones y retoma tu proyecto en un chat nuevo siempre que lo necesites.

<Callout icon="user">
  Disponible en los [**planes Pro y Agencias**](/docs/es/welcome/pricing). Puedes conectarte desde cualquier espacio de trabajo de pago del que seas miembro, aunque tu espacio de trabajo personal esté en el plan Gratis.
</Callout>

## Por qué conectar GitHub

* **Haz una copia de seguridad de tu proyecto en un repositorio privado.** Tu código vive en un repositorio de GitHub que te pertenece.
* **Envía las actualizaciones a GitHub.** Manda tu última versión de Macaly al repositorio como una pull request que tú fusionas.
* **Recupera los cambios en tu proyecto.** Restaura tu proyecto a partir de la versión guardada en GitHub.
* **Importa un proyecto desde GitHub.** Inicia un proyecto de Macaly nuevo a partir de un repositorio que subiste anteriormente.

## Conecta GitHub a tu proyecto

<Steps>
  <Step title="Abre los ajustes de tu proyecto">
    En tu proyecto, haz clic en **Ajustes** en la barra superior y luego abre la pestaña **General**.
  </Step>

  <Step title="Crea el repositorio">
    Desplázate hasta **Conexión con GitHub** y haz clic en **Crear en GitHub**. La primera vez, autorizarás a Macaly en GitHub y elegirás qué cuenta u organización de GitHub conectar. Elige una que ya tenga la aplicación instalada o selecciona **Install on another GitHub account**. Macaly crea entonces un repositorio privado y sincroniza tu proyecto en él.

    <img src="https://mintcdn.com/macaly-41b1d3e9/mNLiN7clTmvYwZ90/images/integrations_github_create.png?fit=max&auto=format&n=mNLiN7clTmvYwZ90&q=85&s=52b1131022af029916fa54a18c0d8733" alt="Ajustes General botón Crear en GitHub de la conexión con GitHub" width="2400" height="1600" data-path="images/integrations_github_create.png" />
  </Step>

  <Step title="Tu repositorio está vinculado">
    Ahora la sección muestra el nombre de tu repositorio con un enlace para abrirlo en GitHub. Desde aquí puedes subir y extraer cambios.
  </Step>
</Steps>

## Sube y extrae cambios

Una vez que tu repositorio está vinculado, la sección **Conexión con GitHub** muestra dos botones:

* **Subir cambios** envía tu última versión de Macaly a GitHub. Macaly abre una pull request titulada "Updates from Macaly" que revisas y fusionas en GitHub.
* **Extraer cambios** sustituye los archivos de tu proyecto por la versión de GitHub. Macaly te pide confirmación antes. Tus archivos `.env` y `.env.local` siempre se conservan.

Para desvincular el repositorio, haz clic en el botón `X` junto a su nombre.

## Importa un proyecto desde GitHub

Puedes iniciar un proyecto de Macaly nuevo a partir de un repositorio que subiste anteriormente desde Macaly.

<Steps>
  <Step title="Activa la acción de importación">
    Abre **Preferencias** en los ajustes de tu cuenta, desplázate hasta **Avanzado** y activa **Importar desde GitHub**. Así la acción aparece en la pantalla principal.

    <img src="https://mintcdn.com/macaly-41b1d3e9/mNLiN7clTmvYwZ90/images/integrations_github_import.png?fit=max&auto=format&n=mNLiN7clTmvYwZ90&q=85&s=062a4da2b66d8f3e5694b99325da393c" alt="Preferencias Avanzado interruptor de Importar desde GitHub" width="2400" height="1600" data-path="images/integrations_github_import.png" />
  </Step>

  <Step title="Abre Importar desde GitHub">
    En la pantalla principal, abre el menú **+** de la barra de prompts y elige **Importar desde GitHub**.
  </Step>

  <Step title="Elige un repositorio">
    Busca el repositorio y selecciónalo. Macaly crea un proyecto nuevo a partir de él. Usa **Configurar** para volver a conectar GitHub o cambiar de cuenta, y **Actualizar** para recargar la lista. Solo verás los repositorios a los que tu cuenta de GitHub tiene acceso.
  </Step>
</Steps>

<Note>
  La importación funciona con repositorios creados por Macaly. No se admite la importación de un repositorio externo, no creado por Macaly.
</Note>

## Qué se sincroniza

Se incluyen los archivos de tu proyecto, los componentes, las páginas, los estilos, los recursos y la configuración de Macaly. Las variables de entorno (los archivos `.env`) y los archivos de caché nunca se envían, y extraer cambios nunca sobrescribe tus `.env` y `.env.local`.

## Datos útiles

* **Los repositorios siempre son privados.** Macaly nunca hace público tu código.
* **Basta con una cuenta de GitHub gratuita.** No necesitas un plan de GitHub de pago.
* **Subir cambios abre una pull request** que fusionas en GitHub. No modifica tu sitio publicado.
* **Extraer cambios sustituye los archivos de tu proyecto** pero conserva tus `.env` y `.env.local`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.