Docs ChanTan Studio
Ouvrir ChanTan Studio
Docs › Publication et domaines

Envoyer le code de votre projet sur GitHub

Gardez une copie de votre projet ChanTan Studio dans votre dépôt GitHub privé : une connexion à faire une fois, un bouton pour pousser, une synchro auto.

Dernière mise à jour:

GitHub est un endroit où conserver une copie des fichiers de votre projet, sur votre propre compte. Si vous n'y avez jamais mis les pieds, vous n'en avez pas besoin : c'est la publication qui met votre application en ligne. GitHub s'adresse à ceux qui veulent posséder leur code.

Deux choses à comprendre d'emblée :

  • C'est à sens unique. ChanTan envoie vos fichiers vers GitHub, jamais l'inverse.
  • Votre dépôt est toujours privé. Vous seul pouvez le voir.
  • Il n'existe aucun téléchargement ZIP du code du projet aujourd'hui. GitHub est le moyen de sortir le code. (Paramètres → « Sécurité »« Exporter les données » télécharge les données de votre compte — profil, liste de projets, historique de crédits — pas le code de votre application.)

1. Connectez votre compte GitHub

Ouvrez Paramètres« Intégrations » et appuyez sur « Connecter ».

Vous pouvez aussi partir de l'intérieur d'un projet : appuyez sur le bouton GitHub dans l'en-tête du projet → « Pousser vers GitHub »« Connecter GitHub ».

2. Approuvez côté GitHub

GitHub vous demande d'approuver la connexion. Acceptez, et vous revenez directement d'où vous veniez.

Quand cela fonctionne, vous voyez « GitHub connecté » et votre @pseudo apparaît sous forme de pastille verte. En cas d'échec, le message est « Impossible de connecter GitHub. Réessayez. » — relancez.

3. Ouvrez votre projet et appuyez sur « Pousser vers GitHub »

Entrez dans le projet que vous voulez sauvegarder — celui de la Boulangerie Lumière, par exemple —, appuyez sur le bouton GitHub de l'en-tête, puis sur « Pousser vers GitHub ».

4. Nommez le dépôt et poussez

La première fois, choisissez un « Nom du dépôt » : il est déjà pré-rempli à partir du nom de votre projet. En dessous, il est écrit : « Créé en dépôt PRIVÉ sur @pseudo — vous seul pouvez le voir. »

Appuyez sur « Créer le dépôt et pousser ».

C'est fait ! À la fin, un bouton « Ouvrir sur GitHub » apparaît. Appuyez dessus pour voir vos fichiers bien rangés dans votre dépôt privé.

Pousser à nouveau plus tard

Après le premier envoi, le bouton devient « Pousser le dernier code », et une ligne au-dessus vous dit la vérité :

Ce qui est écrit Ce que cela veut dire
« Vous avez des changements qui ne sont pas encore sur GitHub. » Appuyez sur « Pousser le dernier code » pour les envoyer
« GitHub est à jour avec ce projet. » Rien à envoyer

Vous ne pouvez pas pousser deux fois le même projet en moins de 30 secondes : vous verriez « Just pushed — give it a few seconds and try again. » (« Envoi tout juste effectué — patientez quelques secondes et réessayez »).

Garder le tout synchronisé automatiquement

Après le premier envoi, une case à cocher apparaît : « Garder GitHub synchronisé automatiquement »« Envoie vos changements sous ~5 minutes. Plusieurs modifications deviennent un seul commit. »

⚠️ « Les fichiers que vous modifiez sur GitHub sont remplacés à la prochaine synchro. Ceux que vous ajoutez restent. » ChanTan fait autorité sur les fichiers qu'il gère : ne faites pas vos modifications du côté de GitHub.

La synchro automatique se désactive d'elle-même après plusieurs échecs, ou immédiatement quand la cause ne peut pas se résoudre seule : GitHub déconnecté, nom de dépôt déjà pris, projet supprimé, ou projet trop volumineux. Recochez la case pour repartir.

Ce qui est protégé

  • Les dépôts sont toujours créés en privé.
  • Vos clés de base de données sont retirées et remplacées par des espaces réservés avant tout envoi.
  • Si ce retrait ne peut pas être garanti, rien n'est envoyé du tout — vous verrez : « We couldn't verify your database keys would be removed, so nothing was pushed. Try again in a moment. » (« Impossible de garantir le retrait de vos clés, donc rien n'a été poussé — réessayez dans un instant »).
  • Les fichiers de configuration contenant des secrets ne sont jamais envoyés.

Les limites, sans détour

Limite Valeur
Fichiers par projet 2 000
Un seul fichier 1 Mo
Projet entier 10 Mo
Même projet poussé à nouveau Pas avant 30 secondes

Autre vérité utile : les messages d'erreur de GitHub reviennent en anglais, même quand le reste de l'application est dans votre langue.

Se déconnecter

Paramètres → « Intégrations »« Déconnecter » → confirmez avec « Oui, déconnecter ».

Vos dépôts ne sont pas supprimés. « Les dépôts sont créés en privé. Déconnecter retire l'accès de Chantan — vos dépôts restent à vous. »

Si vous voyez ensuite « Déconnecté ici, mais GitHub liste encore l'application », terminez le retrait côté GitHub : GitHub → Settings → Applications → supprimez « Chantan Studio ».

À retenir

GitHub est une sauvegarde et un moyen de posséder votre code. Ce n'est pas ainsi que votre application arrive en ligne : pour cela, c'est Publier, et cela reste la bonne façon de mettre votre application devant vos visiteurs.