Versões, Builds e Checkpoints

Entenda como o Skip salva o progresso do seu app e como você pode navegar pelo histórico de alterações com segurança. Esta é uma das páginas mais importantes da documentação, porque contém a distinção entre Restaurar e Reverter — duas ações parecidas, mas com consequências muito diferentes.

Conceitos principais

Build (execução)

Um build — também chamado de execução — é uma rodada completa de trabalho da IA. Sempre que você faz um pedido, o Skip:

1. Pensa no que mudar.

2. Altera o código.

3. Roda verificações.

4. Se tudo correr bem, associa o resultado a uma nova versão do projeto.

Um build pode:

• Falhar (erro em alguma etapa) — mesmo assim, a execução fica registrada na lista para consulta.

• Estar em andamento enquanto você vê a animação de processamento.

Em outras palavras: build não é só "compilar". É o pacote de trabalho completo daquele pedido.

Versão

Uma versão é um marcador do estado do código em um momento do tempo. Aparece como v1, v2, v3... no inspetor ou ao lado da pré-visualização.

• A versão ativa é a que o editor está usando agora para trabalhar e mostrar no preview.

• Versões antigas continuam listadas para você comparar, entender o histórico ou voltar a um ponto anterior.

O Skip também indica quando uma versão coincide com o que está em Produção (site publicado) ou só no Preview — nem sempre são iguais, até você publicar de novo.

Checkpoint

O Checkpoint é o nome que o produto usa para um ponto salvo no histórico, ligado a uma execução e a uma versão. Serve como rede de segurança para "voltar o projeto para como estava aqui".

No painel de versionamento, Checkpoints se relacionam a ações como Restaurar (reativar uma versão antiga sem apagar o histórico posterior) ou Reverter (descartar versões mais novas).

Atenção: Checkpoint é histórico na nuvem do Skip, não é arquivo no seu computador. Você não precisa baixar nada para ter esses pontos de restauração.

Restaurar vs. Reverter

Essa é a diferença mais importante — e a mais confundida — de toda a plataforma. Leia com atenção.

Ação	O que faz	É destrutiva?
Restaurar	Volta o código para uma versão antiga mantendo o registro do que veio depois. É como um "checkout" de versão.	Não. Seu histórico fica intacto.
Reverter	Volta para uma versão e remove as execuções e mensagens posteriores ao ponto escolhido.	Sim. A tela pede confirmação explícita porque não há como desfazer.

Quando usar RestaurarNa dúvida, prefira Restaurar. É a opção segura, não destrutiva, e permite voltar atrás da própria decisão de voltar.Use quando:

• Só quer comparar versões.

• Quer desfazer uma mudança ruim, mas pode querer voltar para o estado atual depois.

• Um build recente quebrou o app e você quer voltar rapidamente para testar.

Quando usar ReverterReverter é destrutivo. Depois de confirmado, não há como desfazer pelo fluxo normal. A tela pede confirmação explícita exatamente por isso.Use apenas quando tiver certeza absoluta de que não precisa mais de nenhuma das execuções e mensagens feitas depois do ponto escolhido.

Resumo rápido de decisão

Situação	Ação recomendada
Só quero comparar ou desfazer temporariamente	Restaurar
Um build quebrou o app e quero voltar	Restaurar
Não quero mais nada do que foi feito depois daquele ponto, de forma definitiva	Reverter

Onde isso aparece no app

• Versão atual: Na barra da pré-visualização, no editor.

• Lista de execuções, abas de Versionamento, QA e outras: No Inspetor de Build (veja a página dedicada).

Plano e permissões

Checkpoints e algumas ações de versão podem exigir um plano com o recurso liberado. Quando for o caso, a interface mostra um ícone de upgrade explicando qual plano é necessário.

Links relacionados

• Inspetor de Build — visualização detalhada das execuções.

• Publicar sua Aplicação — entenda a diferença entre Preview e Produção.

• Bug Scanner — diagnosticar erros na pré-visualização.

• Como voltar a versão do projeto — tutorial passo a passo dessa ação.

Próximo passo: Vá ainda mais fundo no histórico do seu app entendendo o Inspetor de Build, ferramenta que mostra em detalhe tudo o que a IA fez em cada execução.