Project History & Restore

The Project History feature lets you restore your project to any previous state. Automatic snapshots are created before each AI generation, giving you the ability to undo changes and recover from any issues.

How It Works

Automatic Snapshots (Auto-Save)

Every time you make an AI generation request, a snapshot of your project's current state is automatically created before the AI makes any changes. This means:

• You can always restore to the state before any AI generation
• No manual action required — it happens automatically
• Snapshots include all project files with their content

Manual Checkpoints

You can also create manual checkpoints at any time to save your current progress:

1. Click the History button in the chat panel header
2. Click the + Checkpoint button
3. Your current state is saved as a manual checkpoint

Using the History Feature

Accessing Project History

Click the History button in the chat panel header to see your snapshot history. You'll see:

• Auto — Automatic snapshots created before AI generations
• Checkpoint — Manual checkpoints you created
• Backup — Automatic backups created before restores

Restoring to a Previous State

1. Click the History button
2. Find the snapshot you want to restore to
3. Click the restore icon (circular arrow) on that snapshot
4. Click Confirm to restore

Restore from Visual Editor

When using the Visual Editor, you have access to a Revert button that lets you restore to any previous snapshot:

1. Click the Revert button (with dropdown arrow)
2. Select which snapshot to restore to
3. Confirm the restore action

This is useful if you made visual edits you want to undo.

What Gets Saved

Each snapshot includes:

• All project files (code, assets, configuration)
• File contents at that point in time
• Metadata (timestamp, type, description)

Snapshots do NOT include:

• External integrations (Supabase data, etc.)
• Deployed versions

Snapshot Descriptions

Auto snapshots show what prompt triggered them:

This helps you identify which snapshot to restore to.

Best Practices

When to Create Manual Checkpoints

• Before making major changes to your project
• When you reach a stable state you want to preserve
• Before experimenting with new features

Understanding Restore

• Restore replaces all files — Your current files are replaced with the snapshot's files
• Backup is automatic — A backup snapshot is created before every restore
• Chat history is preserved — Your conversation with the AI remains intact

Storage Considerations

• Old snapshots are automatically cleaned up after 30 days
• Maximum of 50 auto snapshots kept per project
• Manual checkpoints are preserved longer

Troubleshooting

"No snapshots available"

This means your project hasn't had any AI generations yet. Make a generation or create a manual checkpoint.

"Failed to restore"

This can happen if:

• You don't have edit permissions on the project
• The snapshot data is corrupted
• Network connectivity issues

Try again or contact support if the issue persists.

Restore didn't seem to work

After restoring, the page will refresh to show the restored state. If you don't see changes:

1. Hard refresh the page (Ctrl+Shift+R / Cmd+Shift+R)
2. Check the History dropdown for the backup that was created
3. Verify you selected the correct snapshot

Feature Summary