> 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.adapta.org/skip/comece-aqui/versoes-builds-e-checkpoints.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.