Onlook automatically creates backups of your project at key moments, allowing you to restore to any previous state. Whether you want to undo an AI change or revert to yesterday's version, version history has you covered.
Key features:
Automatic backups - Created without any action required
One-click restore - Return to any previous state instantly
Named backups - Rename for easy identification
Branch support - Access backups from any branch
AI integration - Quick restore from chat history
View all backups for your current project.
How to access:
Click the Version History button in the top-right corner in the builder
Version History popup opens
All backups are displayed in chronological order (newest first)
What you'll see:
List of all backup snapshots
Timestamp for each backup
Backup name
Restore button for each backup
Rename option for each backup
Onlook automatically creates backups at key moments - no manual action required.
Backups are created when you:
Use AI Chat - Every AI prompt creates a backup before changes are applied
Publish your project - Before deployment, a backup is saved
Make major changes - Significant edits trigger automatic backups
Branch-specific backups:
Each branch has its own independent backup history. Backups created in one branch don't affect other branches.
Return your project to any previous state with a single click.
How to restore:
Open Version History (top-right button)
Browse the list of backups
Find the backup you want to restore to
Click the Restore button next to that backup
Your project instantly returns to that state
What happens when you restore:
All files revert to their state at backup time
Canvas updates to show restored version
Current work is saved as a new backup (before restore)
You can undo the restore by restoring to the most recent backup
Example workflow:
You use AI to redesign a component and then proceed to make many other changes
The result isn't what you wanted
Open Version History
Find the backup from before the AI change
Click Restore
Component returns to previous state
Quick restore directly from your chat history.
How to restore from chat:
Scroll through your AI Chat history
Find the message before the change you want to undo
Hover over that message
Click the Restore button that appears
Project instantly reverts to the state before that AI change
When to use chat restore:
Quick undo of recent AI changes
Faster than opening Version History
See exactly which AI prompt you're reverting
Test different AI approaches by restoring and trying again
Example workflow:
AI makes a change you don't like
Hover over the previous chat message
Click Restore
Try a different prompt for better results
Make backups easier to identify with custom names.
Renaming a backup:
Open Version History
Find the backup you want to rename
Click the rename icon or backup name
Enter a descriptive name
Press Enter or click Save
Why rename backups:
Remember what changed in that version
Mark stable checkpoints
Identify important milestones
Team communication (what this version contains)
Access backups from any branch in your project.
How it works:
Each branch maintains its own backup history
Backups created in one branch stay with that branch
Switching branches shows that branch's backup history
Accessing backups from other branches:
Open Version History
Select branch from dropdown
View backups for that branch
Restore from any branch's backup
Use cases:
Compare different design directions
Restore experimental branch to stable point
Review changes across branches
Find when a bug was introduced
