Docs ChanTan StudioEnvoyer 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.
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.