Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion packages/docs/learn/ask-ai/making-quick-edits.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ You can also ask AI from the inspector panel:
<img src="/images/ask-ai/inline-ask-ai-inspector.png" alt="Quick edits in the inspector panel" />
</Frame>

AI replaces or modifies the selected element based on your prompt.
Ask AI previews the change in a review tray so you can compare options before applying it — see [Reviewing variations](#reviewing-variations).

## Quick insert with AI

Expand All @@ -46,3 +46,13 @@ Open the [quick insert](/learn/design-mode/adding-elements) <Icon icon="plus" si
4. Press **Ask AI to insert...**

AI adds the new element next to your selection, automatically applying layout and wrapping stacks for you.

## Reviewing variations

Ask AI previews each quick edit or insert in a floating tray before anything is committed. When there are several good directions, it returns up to three **variations** to choose from.

{/* TODO: Add a screenshot of the variation review tray */}

1. Click a variation card to apply it live on the canvas. For edits, an **Original** card restores the pre-edit state.
2. To explore other directions, type a new instruction in the quick-edit bar — now labeled **Refine...** — to regenerate the whole set.
3. Click **Keep** to apply the selected variation, or **Discard** to dismiss the changes.