> ## 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

> Sauvegardez et synchronisez votre projet Macaly avec GitHub

L'intégration GitHub de Macaly connecte votre projet à un dépôt GitHub privé. Sauvegardez votre code, synchronisez les modifications dans les deux sens et reprenez votre projet dans un nouveau chat dès que vous en avez besoin.

<Callout icon="user">
  Disponible avec les [**forfaits Pro et Agences**](/docs/fr/welcome/pricing). Vous pouvez vous connecter via n'importe quel workspace payant dont vous êtes membre, même si votre workspace personnel est sur le forfait Gratuit.
</Callout>

## Pourquoi connecter GitHub

* **Vous sauvegardez votre projet dans un dépôt privé.** Votre code vit dans un dépôt GitHub que vous possédez.
* **Vous envoyez vos mises à jour sur GitHub.** Votre dernière version Macaly part vers le dépôt sous forme de pull request que vous fusionnez vous-même.
* **Vous récupérez les modifications dans votre projet.** Restaurez votre projet à partir de la version stockée sur GitHub.
* **Vous importez un projet depuis GitHub.** Démarrez un nouveau projet Macaly à partir d'un dépôt que vous avez envoyé plus tôt.

## Connectez GitHub à votre projet

<Steps>
  <Step title="Ouvrez les paramètres de votre projet">
    Dans votre projet, cliquez sur **Paramètres** dans la barre du haut, puis ouvrez l'onglet **Général**.
  </Step>

  <Step title="Créez le dépôt">
    Faites défiler jusqu'à **Connexion GitHub** et cliquez sur **Créer sur GitHub**. La première fois, vous autorisez Macaly sur GitHub, puis vous choisissez le compte ou l'organisation GitHub à connecter. Sélectionnez-en un où l'application est déjà installée, ou choisissez **Install on another GitHub account**. Macaly crée alors un dépôt privé et y synchronise votre projet.

    <img src="https://mintcdn.com/macaly-41b1d3e9/mNLiN7clTmvYwZ90/images/integrations_github_create.png?fit=max&auto=format&n=mNLiN7clTmvYwZ90&q=85&s=52b1131022af029916fa54a18c0d8733" alt="Bouton Créer sur GitHub dans Paramètres Général Connexion GitHub" width="2400" height="1600" data-path="images/integrations_github_create.png" />
  </Step>

  <Step title="Votre dépôt est connecté">
    La section affiche maintenant le nom de votre dépôt avec un lien pour l'ouvrir sur GitHub. Vous pouvez désormais envoyer et récupérer des modifications depuis cet endroit.
  </Step>
</Steps>

## Envoyer et récupérer des modifications

Une fois votre dépôt connecté, la section **Connexion GitHub** affiche deux boutons :

* **Pousser les modifications** envoie votre dernière version Macaly vers GitHub. Macaly ouvre une pull request intitulée « Updates from Macaly » que vous vérifiez et fusionnez sur GitHub.
* **Récupérer les modifications** remplace les fichiers de votre projet par la version de GitHub. Macaly vous demande d'abord de confirmer. Vos fichiers `.env` et `.env.local` sont toujours conservés.

Pour dissocier le dépôt, cliquez sur le bouton `X` à côté de son nom.

## Importer un projet depuis GitHub

Vous pouvez démarrer un nouveau projet Macaly à partir d'un dépôt que vous avez précédemment envoyé depuis Macaly.

<Steps>
  <Step title="Activez l'action d'import">
    Ouvrez **Préférences** dans les paramètres de votre compte, faites défiler jusqu'à **Avancé**, puis activez **Importer depuis GitHub**. Cela affiche l'action sur l'écran d'accueil.

    <img src="https://mintcdn.com/macaly-41b1d3e9/mNLiN7clTmvYwZ90/images/integrations_github_import.png?fit=max&auto=format&n=mNLiN7clTmvYwZ90&q=85&s=062a4da2b66d8f3e5694b99325da393c" alt="Interrupteur Importer depuis GitHub dans Préférences" width="2400" height="1600" data-path="images/integrations_github_import.png" />
  </Step>

  <Step title="Ouvrez le menu d'import">
    Sur l'écran d'accueil, ouvrez le menu **+** dans la barre de prompt et choisissez **Importer depuis GitHub**.
  </Step>

  <Step title="Choisissez un dépôt">
    Recherchez le dépôt et sélectionnez-le. Macaly en crée un nouveau projet. Utilisez **Configurer** pour vous reconnecter à GitHub ou changer de compte, et **Actualiser** pour recharger la liste. Seuls les dépôts auxquels votre compte GitHub a accès s'affichent.
  </Step>
</Steps>

<Note>
  L'import fonctionne uniquement avec des dépôts créés par Macaly. L'import d'un dépôt externe, non créé par Macaly, n'est pas pris en charge.
</Note>

## Ce qui est synchronisé

Vos fichiers de projet, composants, pages, styles, ressources et configuration Macaly sont inclus. Les variables d'environnement (fichiers `.env`) et les fichiers de cache ne sont jamais envoyés, et la récupération n'écrase jamais vos fichiers `.env` et `.env.local`.

## Bon à savoir

* **Les dépôts sont toujours privés.** Votre code n'est jamais rendu public par Macaly.
* **Un compte GitHub gratuit suffit.** Vous n'avez pas besoin d'un forfait GitHub payant.
* **L'envoi ouvre une pull request** que vous fusionnez sur GitHub. Cela ne modifie pas votre site en ligne.
* **La récupération remplace les fichiers de votre projet**, mais conserve vos fichiers `.env` et `.env.local`.


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