> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vybe.build/llms.txt
> Use this file to discover all available pages before exploring further.

# Version History & Rollback

> Vybe automatically saves checkpoints as you build so you can restore your app to a previous state

Vybe automatically saves a checkpoint of your app's code every time the AI finishes making changes. If something goes wrong, you can restore to any previous checkpoint directly from the chat.

***

## How checkpoints work

Every time the AI modifies your app's files and finishes responding, Vybe saves a checkpoint — a snapshot of all your source files at that moment. You'll see a confirmation appear below the AI's message:

> Your progress has been saved.

Each checkpoint is tied to a specific AI response in your conversation. This gives you a restore point for every set of changes the AI makes.

You do not need to manually save your work. Checkpoints are created automatically whenever the AI modifies files.

***

## Restoring to a checkpoint

If the AI makes a change that breaks your app or produces an undesired result, you can restore to any previous checkpoint.

<Steps>
  <Step title="Find the checkpoint in the chat">
    Scroll through the conversation to find the checkpoint you want to restore to — the last point where your app was in a good state. Each checkpoint appears directly below the AI message that created it.
  </Step>

  <Step title="Click Restore">
    Click the **Restore** button on the checkpoint. A confirmation dialog appears showing what will happen.
  </Step>

  <Step title="Confirm the restore">
    Review the confirmation and click to proceed. The restore:

    * Reverts all source files to their state at that checkpoint
    * **Deletes all chat messages** in the current thread that came after that checkpoint
  </Step>
</Steps>

<Warning>
  Restoring to a checkpoint is irreversible. All chat messages after the selected checkpoint are permanently deleted from the current thread. Make sure you have selected the right checkpoint before confirming.
</Warning>

***

## What restore affects

**Restored:**

* All source files — code, components, pages, API routes, and configuration files are reverted to their state at the checkpoint
* File structure — files added after the checkpoint are removed; files deleted after the checkpoint are brought back

**Not restored:**

* **Database data** — if the AI created tables, ran migrations, or inserted data after the checkpoint, those changes remain in your database. You may need to ask the AI to adjust the database separately after restoring
* **Published deployments** — restoring does not affect your live deployed app. If you want the deployed version to reflect the restored code, you need to publish again after restoring

***

## Best practices

* **Restore early** — if you notice an issue, restore before the AI makes additional changes on top of the problem. This keeps your conversation clean and avoids compounding errors
* **Build in small steps** — making one change at a time means each checkpoint captures a focused set of changes, making it easier to identify exactly where something went wrong
* **Re-publish after restoring** — if your app is deployed and you restore to a previous checkpoint, remember to publish again so the live version matches your restored code

***

## What's next

* Learn about recipes for pre-configured starters: [Recipes](/building-apps/recipes)
* Customize AI behavior for your app: [Custom Instructions](/building-apps/custom-instructions)
* Deploy your app when it is ready: [Deploying](/deployment/deploying)