Controle de Versão

Cada alteração é commitada em um repositório privado do GitHub gerenciado pelo Proyecta. Navegue e alterne entre snapshots anteriores usando o menu de versões na barra de ferramentas do builder.

Cada alteração que a IA faz no seu app é commitada em um repositório privado do GitHub gerenciado pelo Proyecta. Seu código está sempre acessível e pode ser exportado pelo builder.

Histórico de Versões

Use o menu de versões na barra de ferramentas do builder para alternar entre snapshots. No celular, acesse o Histórico de Versões pelo menu More. Ao visualizar uma versão anterior, clique em Open history no banner de versão para ver a lista completa de versões. Cada versão exibe:

• Seu número de versão (ex.: “v12”)
• Um rótulo (ex.: ‘v1 (pre-cloud)’ para o snapshot inicial apenas com frontend, ou em branco para versões de iteração)
• O timestamp de criação no seu fuso horário local
• Os primeiros 7 caracteres do hash do commit git

Abrindo uma versão anterior

Clique em qualquer card de versão para abrir aquele snapshot na pré-visualização. Versões anteriores são abertas em modo somente leitura — você pode inspecionar o código e a pré-visualização, mas não pode editar a partir de uma visualização histórica.

Enquanto você navega por uma versão anterior, um banner abaixo da barra de ferramentas exibe “Viewing version N in read-only mode.” Clique em Return to latest no banner para voltar ao estado de trabalho atual e retomar a edição.

Se você nunca editou nada, o painel exibe “No snapshots yet — versions are created automatically after builder turns that commit changes.”

Como eu faço um revert de verdade?

O revert com um clique a partir do painel de Histórico de Versões está no roadmap. Por enquanto, você tem duas opções:

1. Peça para a IA — "Revert the last change", "Go back to how the homepage looked in version 6", "Undo everything from the last three commits". A IA lê o histórico e aplica o commit reverso para você.
2. Use git no Terminal — para controle preciso:

# View recent commits
git log --oneline -20

# Revert a specific commit (creates a new commit undoing it)
git revert <commit-hash>

# Or reset to a specific point (destructive)
git reset --hard <commit-hash>

GitHub

O código do seu projeto é armazenado em um repositório privado do GitHub gerenciado pelo Proyecta. Você pode acessar o código diretamente pelo editor de código dentro do builder ou exportá-lo. Se você tiver conectado sua própria organização do GitHub, o repositório será criado lá.

Perguntas Frequentes

O que está incluído em cada versão?

Alterações de código, atualizações de configuração e modificações de schema — tudo que vive no git. Assets armazenados fora do repositório (como arquivos enviados e registros do banco de dados) não são versionados.

Posso criar branches?

Sim. Use o Terminal para criar e alternar branches: git checkout -b feature/new-homepage. A IA fará commits no branch que estiver ativo no momento.

Como colaboro com minha equipe?

Vários membros da equipe podem acessar o mesmo repositório no GitHub. Use os fluxos de trabalho padrão do git (branches, pull requests) para colaboração.

Em breve

• Revert com um clique — um botão “Revert to this version” no painel de Histórico de Versões que cria uma nova versão correspondente a um snapshot mais antigo
• Tags de versão personalizadas — nomeie versões individuais para encontrá-las mais facilmente depois