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

# GitHub

> Sauvegardez votre projet Macaly sur GitHub et accédez à votre code source

L'intégration GitHub de Macaly vous permet de sauvegarder l'intégralité de votre projet dans un dépôt GitHub privé. Vous pouvez envoyer des mises à jour à tout moment et restaurer à partir d'une sauvegarde si nécessaire.

## Que fait l'intégration GitHub ?

L'intégration GitHub vous offre :

* **Des sauvegardes externes** de votre projet stockées sur GitHub
* **Un historique des versions** pour voir comment votre projet a évolué dans le temps
* **Un accès au code source** pour visualiser, cloner ou télécharger le code de votre projet depuis GitHub

Elle fonctionne comme un outil de sauvegarde et d'accès au code. Vous envoyez votre projet sur GitHub quand vous souhaitez un instantané, et vous pouvez restaurer à partir de cette sauvegarde dans un nouveau projet.

## Comment le configurer

<Steps>
  <Step title="Connectez votre compte GitHub">
    Allez dans **Paramètres → Général** et cliquez sur **Connecter GitHub**. Vous serez redirigé vers GitHub pour autoriser la connexion. Une fois approuvé, vous revenez dans Macaly.

    Vous n'avez besoin de faire cela qu'une seule fois.
  </Step>

  <Step title="Créez un dépôt">
    Cliquez sur **Créer sur GitHub** pour créer un nouveau dépôt sur GitHub et commencer la synchronisation de votre code. Macaly crée un dépôt privé et télécharge tous les fichiers de votre projet. Vous verrez un lien vers le dépôt une fois terminé.
  </Step>

  <Step title="Envoyez les mises à jour">
    Après avoir effectué des modifications dans Macaly, cliquez sur **Envoyer les modifications** pour envoyer la dernière version sur GitHub. Cela crée une Pull Request dans votre dépôt. Rendez-vous sur GitHub pour la vérifier et la fusionner.
  </Step>

  <Step title="Restaurez depuis GitHub">
    Cliquez sur **Récupérer les modifications** pour restaurer depuis votre dépôt GitHub. Cela met à jour votre **projet actuel** : tous les fichiers sont remplacés par la version de GitHub, tandis que vos variables d'environnement (.env) restent inchangées.
  </Step>
</Steps>

## Puis-je télécharger le code de mon projet ?

Oui. Une fois que vous avez envoyé votre projet sur GitHub, le code source complet est disponible dans votre dépôt GitHub. Vous pouvez :

* **Visualiser** le code directement sur GitHub
* **Cloner** le dépôt sur votre ordinateur avec Git
* **Télécharger** le code sous forme de fichier ZIP depuis GitHub

## Puis-je exporter mon projet et l'héberger ailleurs ?

Oui, vous pouvez télécharger le code source de votre projet depuis GitHub une fois la sauvegarde envoyée. Cependant, les projets Macaly sont conçus pour fonctionner sur l'infrastructure d'hébergement de Macaly, donc exécuter le code en dehors de Macaly peut nécessiter une configuration supplémentaire.

## Que contient la sauvegarde ?

Votre sauvegarde inclut tous les fichiers du projet, les composants, les pages, les styles, les ressources et la configuration. Les variables d'environnement et les fichiers de cache **ne sont pas** inclus dans la sauvegarde.

## Bon à savoir

* **La récupération met à jour votre projet actuel** : tous les fichiers sont remplacés par la version GitHub, mais les variables d'environnement restent inchangées
* **Les dépôts sont toujours privés** : votre code n'est pas visible publiquement sur GitHub
* **Un compte GitHub gratuit suffit** : vous n'avez pas besoin d'un forfait GitHub payant
* **Vous pouvez déconnecter GitHub** : utilisez l'option de déconnexion dans les Paramètres pour dissocier GitHub de votre projet à tout moment


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