Versions
Versions let you move backward or forward through your app's history so you can easily undo changes or revisit earlier states.
What is a version?
Versions allow you to return to an earlier state of your app whenever you need to. If you don't like the changes the AI Agent made, or want to go back a few steps in your project's history, versions provide a simple way to do that.
How versions are created
Every time the AI Agent updates your code and successfully deploys your app, Beautiful.dev automatically creates a new version. Each version represents a checkpoint you can move forward or backward to at any time.
This means you can safely experiment with changes, knowing you can always return to a previous state.
Restoring a version
To restore a version:
Locate the message associated with that version.
Click Restore version at the bottom of the message.
Restoring can take a couple of minutes. Once complete, your project's preview environment will update to match the selected version.
Published vs. preview version
Restoring a version does not affect your published app (if you have one). Published apps remain stable until you explicitly publish again.
Inside the versions, you'll see:
Publishedbadge: shows which version is currently live to your usersPreviewbadge: shows which version your preview environment is currently displaying
These markers help you understand exactly where your preview and published apps are in the version history.