> ## Documentation Index
> Fetch the complete documentation index at: https://subframe-59800133-mintlify-annotations-ai-handoff-1775859770.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Annotations

> Add implementation notes to guide AI prototype generation and code handoff.

<Frame>
  <img src="https://mintcdn.com/subframe-59800133-mintlify-annotations-ai-handoff-1775859770/UHr1GDmWOF9ZCK12/images/prototype-mode/annotation-example.png?fit=max&auto=format&n=UHr1GDmWOF9ZCK12&q=85&s=4dcd684f5b0adefd418f6ad269c832c3" alt="Example of an annotation on an element" width="712" height="469" data-path="images/prototype-mode/annotation-example.png" />
</Frame>

Annotations let you add implementation notes to your design. They are used by prototype mode to instruct AI how your designs should behave.

## Adding annotations

1. Click **Annotate** in navbar
2. Click on an element in canvas
3. Type the annotation
4. Press <kbd>Cmd</kbd> + <kbd>Enter</kbd> to save

You should see blue dots on elements for each annotation.

## Exporting to code

Annotations double as implementation notes for design-to-code handoff. When you export a page, annotations are included as code comments — so any context you leave during design time carries over automatically.

<Frame>
  <img src="https://mintcdn.com/subframe-59800133-mintlify-annotations-ai-handoff-1775859770/UHr1GDmWOF9ZCK12/images/prototype-mode/annotation-as-code.png?fit=max&auto=format&n=UHr1GDmWOF9ZCK12&q=85&s=7018ad9ec5ef982b15eb6c5c2f996921" alt="Annotation persisted as code comment" width="493" height="76" data-path="images/prototype-mode/annotation-as-code.png" />
</Frame>

### Using annotations with AI agents

When an AI coding assistant like Claude Code, Cursor, or Codex fetches your design via the [MCP server](/guides/mcp-server), it reads your annotations as part of the exported code. This means you can leave implementation notes while designing — describing desired behaviors, edge cases, or business logic — and your AI agent will pick them up and act on them during implementation.

<Note>Use annotations to capture implementation details as you design, so nothing gets lost during handoff. For example, annotate a button with "Submit form and redirect to /dashboard on success" or a list with "Fetch from /api/items, show skeleton loader while loading."</Note>
