Synchronisation GitHub et export : votre code Mythex vous appartient

Le code que vous construisez sur Mythex vous appartient, et vous pouvez l'emporter avec vous. Sur Pro, vous pouvez synchroniser un projet avec un dépôt GitHub, télécharger l'ensemble sous forme d'archive .tar.gz, ou importer une archive dans un projet. Les secrets sont exclus des exports, donc une archive peut être déplacée sans risque.

Ce que cela permet

Mythex vous offre trois façons de faire entrer et sortir du code d'un projet :

Synchronisation GitHub : reliez un dépôt et envoyez ou récupérez les changements entre lui et votre projet.
Export : téléchargez le projet en archive .tar.gz depuis les paramètres du projet.
Import : remplacez les fichiers d'un projet par le contenu d'une archive .tar.gz, .tgz ou .zip.

Si vous n'avez jamais utilisé GitHub, ce qu'est GitHub présente les bases : c'est là que la plupart des développeurs gardent leur code, suivent les modifications et relisent le travail des autres.

Pourquoi c'est important

Un créateur d'apps qui retient votre code en otage est un risque. Si vous le dépassez, si vous engagez un développeur, ou si vous voulez simplement une copie sur votre propre machine, vous devez pouvoir partir avec tout.

La page sur la propriété des données de Mythex le dit clairement : tout ce qui est construit dans votre projet vous appartient. Vous pouvez continuer à construire dans Mythex, exporter ou synchroniser avec GitHub. La synchronisation GitHub est aussi le point de passage naturel lorsqu'une équipe d'ingénierie reprend un projet : elle obtient un dépôt normal contenant le projet complet.

Comment utiliser la synchronisation GitHub

Connectez GitHub depuis les paramètres, pendant que vous êtes connecté à Mythex. Cela utilise la connexion OAuth de GitHub.
Reliez un dépôt au projet.
Envoyez ou récupérez les changements depuis le projet vers ce dépôt.

La connexion GitHub sert uniquement à synchroniser des dépôts. Ce n'est pas un moyen de vous connecter à Mythex : vous vous connectez toujours avec votre e-mail ou Google.

Un conseil de la documentation : créez un point de contrôle propre avant toute opération de type force-push sur vos propres dépôts distants, afin d'avoir un état sûr vers lequel revenir.

Comment exporter

Ouvrez paramètres du projet → Export.
Téléchargez le projet en archive .tar.gz.

Les secrets et node_modules (les paquets installés, qui peuvent être reconstruits) sont exclus. L'archive peut donc être partagée ou déplacée entre environnements sans risque. Il vous faudra ajouter à nouveau vos secrets à l'endroit où vous exécutez l'app. Si vous prévoyez de lancer l'app ailleurs, comment exporter et héberger soi-même une app construite avec l'IA détaille les étapes.

Comment importer

L'import ajoute une archive au projet actuel. Il n'existe pas de flux distinct « créer un projet à partir d'une archive » depuis le tableau de bord ; créez donc d'abord un projet si vous en voulez un vide.

Ouvrez paramètres du projet → Export.
Choisissez Import into this project.
Sélectionnez un fichier .tar.gz, .tgz ou .zip.

Ce qui se passe :

Les fichiers du projet sont remplacés par le contenu de l'archive.
Les secrets existants du projet sont conservés.
Les fichiers .env de l'archive sont supprimés. Ajoutez de nouveau ces valeurs dans les réglages.

L'import est utile pour restaurer une sauvegarde ou pour faire entrer une base de code existante dans un projet vide.

Ce que Mythex continue d'héberger

L'export vous donne une copie ; il ne déplace rien hors de Mythex. Tant que le projet existe, Mythex héberge :

les fichiers du projet, dans votre bac à sable privé
la base de données et le stockage de fichiers, si vous les avez activés
l'app publiée, jusqu'à ce que vous la dépubliiez ou supprimiez le projet

Supprimer un projet ou votre compte retire vos apps de l'hébergement Mythex. Exportez d'abord si vous voulez une copie locale.

Secrets et Git

Les clés d'API dans les secrets de votre projet servent à votre app lorsqu'elle tourne. Ne les committez pas dans Git. Les exports les excluent déjà, et les imports suppriment les fichiers .env, donc les valeurs par défaut aident. Mais si vous ajoutez vous-même des fichiers à votre dépôt, gardez les clés à l'écart. Ce que sont les variables d'environnement et les secrets explique pourquoi.

Limites

L'export et la synchronisation GitHub sont des fonctionnalités Pro. Sur Free, vous pouvez consulter le code en lecture seule et utiliser l'aperçu et le terminal ; passez à un abonnement supérieur pour télécharger ou synchroniser.
L'import remplace les fichiers. Il ne fusionne pas. Exportez d'abord si vous voulez peut-être retrouver la version actuelle.
Les exports excluent les secrets et node_modules. Prévoyez de rajouter vos clés et de réinstaller les paquets ailleurs.