Versions and drafts
Why every change becomes a version, what a draft is, and which version the next AI turn builds on.
EaseKit never overwrites your animation. Every finished change is saved as a new version in the session, and hand edits wait in a draft until you apply them. Knowing the difference explains most of what you see in the Versions strip, the Apply bar and the chat.
Versions
A version is a complete, saved state of the animation with its own quality report. Versions are numbered in order (v1, v2 …) and never change after they're made. Each one records where it came from:
| Origin | Made by |
|---|---|
| AI | A chat answer (or Claude via MCP) |
| Edited | Applied hand edits, Continue from This Version, a kept strength dial |
| Feedback | A feedback chip applied instantly (⌥-click) |
| Tempo | Applied tuning |
| Reduced Motion | A saved reduced-motion variant |
| Imported | SVG, Lottie, Figma or JSON imports |
| Sequence | A sequence built from frames |
Hover a version in the strip to see its origin; History lists origin and time for all of them. Versions that weren't made by the AI or an import carry a small ring next to their score.
Drafts
When you edit by hand (drag a layer, change a color, move a keyframe), EaseKit doesn't create a version for every step. The changes collect in a draft on top of the version you're looking at, and an Apply bar replaces the Versions strip with the draft's live score.
- Apply (⌘↩) saves the draft as a new version. A pill says “Saved as version 7” with Undo.
- Discard throws the draft away.
- Inside the draft, ⌘Z and ⇧⌘Z step through single edits.
Which version the AI builds on
The AI always builds on the version you're looking at, not automatically on the newest one. If you click v3 while v5 exists, the chat shows “Next change builds on v3” with Use v5. Your next message then creates v6 from v3; nothing in v4 or v5 is lost.
If you edited by hand since the AI's last version, EaseKit tells the AI what you changed and asks it to keep those edits.
When a new version arrives during a draft
If a new version shows up while you have an unsaved draft (an AI answer finished, Claude edited the session over MCP, or you picked another version), EaseKit sets the draft aside instead of losing it. A pill says “Unsaved stage edits were set aside” with Restore for 10 seconds.
Checkpoints
A checkpoint is a name on a version. ⌘S sets one on the current version (named after the time); right-click a version to name or rename it. Checkpoints change nothing about the animation; they make versions easy to find in History with Checkpoints only.