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

# Version History

> Learn how to manage, view, and restore previous versions of your Mocha projects

# Managing Version History

Every prompt you send in Mocha creates a new version of your project. This version history allows you to track changes, view previous states, and restore to earlier versions if needed.

## Understanding Versions

Each version represents a snapshot of your project at a specific point in time. You can:

* View previous versions to see how your project looked
* Restore to an earlier version if needed
* Duplicate versions to work on multiple variations

<Frame caption="Viewing and interacting with versions of your project">
  <img src="https://mintcdn.com/mocha-47857bf6/yxhIdHUepwfUyu7I/images/versions-of-your-project.png?fit=max&auto=format&n=yxhIdHUepwfUyu7I&q=85&s=06b065e3e5f5b35534b7cf06c6bd88a7" alt="Version management interface" width="1710" height="844" data-path="images/versions-of-your-project.png" />
</Frame>

## Viewing Previous Versions

The "View" option lets you explore previous versions without making any changes. This is perfect for:

* Checking how your project looked at a specific point
* Taking screenshots of previous designs
* Comparing different iterations

<Frame caption="Viewing a previous version">
  <img src="https://mintcdn.com/mocha-47857bf6/yxhIdHUepwfUyu7I/images/view-version.gif?s=a1e3e92cc46b01cc6d706d10ad849a69" alt="Viewing a previous version" width="800" height="392" data-path="images/view-version.gif" />
</Frame>

## Restoring Versions

When you restore to a previous version:

* Your project returns to that exact state
* All versions created after that point are removed
* You can continue working from that restored point

<Frame caption="Restoring to a previous version">
  <img src="https://mintcdn.com/mocha-47857bf6/yxhIdHUepwfUyu7I/images/restore-version.gif?s=0f538942c748c5acddd3a51ba8e065f2" alt="Restoring a version" width="800" height="394" data-path="images/restore-version.gif" />
</Frame>

<Warning>
  Restoring a version is permanent and cannot be undone. All versions created after the restored point will be deleted.
</Warning>

## Working with Multiple Versions

If you want to keep both the current and previous versions:

1. View the version you're interested in
2. Use the "Duplicate" feature to create a new project
3. Work on both versions independently

<Frame caption="Duplicating a version to work on multiple variations">
  <img src="https://mintcdn.com/mocha-47857bf6/yxhIdHUepwfUyu7I/images/duplicate.png?fit=max&auto=format&n=yxhIdHUepwfUyu7I&q=85&s=b305988618db1a97f7017feafaf1abd6" alt="Duplicating a version" width="1715" height="839" data-path="images/duplicate.png" />
</Frame>

<Tip>
  Use version duplication when you want to explore different design directions or maintain multiple variations of your project.
</Tip>

## Best Practices

<Steps>
  <Step title="Regular Checkpoints">
    Make incremental, atomic changes so that you have nice, clean version history
  </Step>

  <Step title="View Before Restoring">
    Always view a version before restoring to ensure it's the right one
  </Step>

  <Step title="Use Duplication">
    When in doubt, duplicate instead of restoring to preserve your work
  </Step>
</Steps>
