> For the complete documentation index, see [llms.txt](https://docs.adapta.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adapta.org/skip/comece-aqui/versoes-builds-e-checkpoints.md).

# 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).

{% hint style="info" %}
**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.
{% endhint %}

### 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 Restaurar**Na 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 Reverter**Reverter é 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.

{% hint style="success" %}
**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.
{% endhint %}