Sincronização e exportação com GitHub: o seu código na Mythex é seu

O código que cria na Mythex é seu, e pode levá-lo consigo. No plano Pro, pode sincronizar um projeto com um repositório do GitHub, descarregar tudo como arquivo .tar.gz, ou importar um arquivo de volta para um projeto. Os segredos ficam de fora das exportações, por isso um arquivo pode ser movido sem risco.

O que faz

A Mythex oferece três formas de mover código para dentro e para fora de um projeto:

Sincronização com o GitHub — ligue um repositório e envie ou receba alterações entre ele e o seu projeto.
Exportar — descarregue o projeto como arquivo .tar.gz a partir das definições do projeto.
Importar — substitua os ficheiros de um projeto pelo conteúdo de um .tar.gz, .tgz ou .zip.

Se nunca usou o GitHub, o que é o GitHub explica o básico: é onde a maioria dos programadores guarda o código, acompanha alterações e revê o trabalho uns dos outros.

Porque é importante

Um construtor de apps que retenha o seu código como refém é um risco. Se quiser sair, contratar um programador, ou simplesmente ter uma cópia na sua própria máquina, deve poder levar tudo consigo.

A página sobre propriedade dos dados da Mythex diz isto com clareza: tudo o que é construído no seu projeto lhe pertence. Pode continuar a construir na Mythex, exportar ou sincronizar com o GitHub. A sincronização com o GitHub é também o ponto natural de passagem quando uma equipa de engenharia assume o projeto: recebe um repositório normal com o projeto completo.

Como usar a sincronização com o GitHub

Ligue o GitHub nas definições, com a sua sessão iniciada na Mythex. Isto usa o início de sessão OAuth do GitHub.
Ligue um repositório ao projeto.
Envie ou receba alterações a partir do projeto, em relação a esse repositório.

A ligação ao GitHub serve apenas para sincronizar repositórios. Não é uma forma de iniciar sessão na Mythex — continua a entrar com email ou com a Google.

Uma dica da documentação: crie um ponto de controlo limpo antes de fazer operações do tipo force-push nos seus próprios remotos, para ter um sítio seguro para onde voltar.

Como exportar

Abra Definições do projeto → Exportar.
Descarregue o projeto como arquivo .tar.gz.

Os segredos e a pasta node_modules (pacotes instalados, que podem ser recriados) ficam de fora. Assim, o arquivo pode ser partilhado ou movido entre ambientes sem risco. Terá de voltar a adicionar os seus segredos onde quer que o execute. Se planeia correr a app noutro sítio, como exportar e alojar por conta própria uma app criada com IA explica os passos.

Como importar

A importação traz um arquivo para o projeto atual. Não existe um fluxo separado de «criar um projeto a partir de um arquivo» no painel, por isso comece por criar um projeto se precisar de um vazio.

Abra Definições do projeto → Exportar.
Escolha Importar para este projeto.
Selecione um ficheiro .tar.gz, .tgz ou .zip.

O que acontece:

Os ficheiros do projeto são substituídos pelo conteúdo do arquivo.
Os segredos existentes do projeto mantêm-se.
Os ficheiros .env do arquivo são removidos. Volte a adicionar esses valores nas Definições.

A importação é útil para restaurar uma cópia de segurança ou trazer uma base de código existente para um projeto vazio.

O que a Mythex continua a alojar

Exportar dá-lhe uma cópia; não move nada para fora da Mythex. Enquanto um projeto existir, a Mythex aloja:

Os ficheiros do projeto, no seu sandbox privado
A base de dados e o armazenamento de ficheiros, se os tiver ativado
A app publicada, até a despublicar ou eliminar o projeto

Eliminar um projeto ou a sua conta remove as suas apps do alojamento da Mythex. Exporte primeiro se quiser uma cópia local.

Segredos e Git

As chaves de API dos segredos do seu projeto servem para a sua app quando corre. Não as envie para o Git. As exportações já as deixam de fora e as importações removem os ficheiros .env, por isso as predefinições ajudam — mas se acrescentar ficheiros ao repositório manualmente, mantenha as chaves fora. O que são variáveis de ambiente e segredos explica porquê.

Limites

Exportar e a sincronização com o GitHub são funcionalidades do Pro. No plano gratuito pode ver o código apenas para leitura e usar a pré-visualização e o terminal; faça o upgrade para descarregar ou sincronizar.
A importação substitui ficheiros. Não faz fusão. Exporte primeiro se quiser poder recuperar a versão atual.
As exportações excluem segredos e node_modules. Terá de voltar a adicionar as chaves e reinstalar os pacotes noutro sítio.