> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Frames

> Frame kinds, the per-frame action bar, and the Build and Focus actions on Canvas.

Every tile on the Canvas is a **frame**. Frames are what you select, drag, and act on. This page covers the frame kinds, the per-frame action bar that surfaces on selection, and the capabilities you trigger from it: Build and Focus.

![Canvas with three frames laid out on the board: a Website (Scroll Hero), an APEX X1 Design System, and a Design mockup of the APEX X1 supercar, with the floating toolbar (Chat, Draw, Edit, Generate) at the bottom](https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-overview.png?fit=max\&auto=format\&n=OIImiKPshhawqFXK\&q=85\&s=5cd2330c89bbdedfb249151ee582f070)

## Frame kinds

The two main kinds are **Artifacts** (live, app-backed surfaces) and **Designs** (mockups). The frame's top-left header shows which kind it is.

| Kind | Header label | Backed by | Interact like a live app? | Convert to a real app? |
| - | - | - | - | - |
| Artifact | **Website**, **Slides**, etc. | A running artifact | Yes | Already an app. |
| Mobile artifact | **Mobile app** | A running artifact | Yes (in simulator) | Already an app. |
| Design | **Design** | Static / interactive mock | Interactive frame only | Yes — via the per-frame **Build…** menu. See [Build](#build). |
| Image | **Image** | Generated PNG / JPG | No | No — use as a reference. |
| Video | **Video** | Generated video | No | No. |
| Vector graphic | **Graphic** | Generated SVG | No | No — embed in a real app. |

> [!NOTE]
>
> Whether a Design frame behaves as a static image or an interactive prototype depends on the **Interactive frames** capability. When it's enabled, Design frames respond to clicks and form input like a real page; otherwise they render as a snapshot you can iterate on but not click through.

## Preview on different devices

See how a design looks on different screen sizes. Ask Agent to show you a mobile, tablet, or desktop version, for example "Show me the mobile version of this page", and it renders a frame at that size:

* **Mobile**: 390 × 844
* **Tablet**: 768 × 1024
* **Desktop**: 1280 × 720

## Per-frame action bar

Selecting a frame surfaces an action bar. The actions depend on the frame's kind.

### Artifact and Design frames

For Artifact (Website, Slides, etc.) and Design frames, the action bar runs across the top of the frame.

![Canvas with an APEX X1 Design frame selected, showing the per-frame action bar across the top with the kind label and the Build, Focus, and more-options actions, the frame attached as a chip in the chat prompt box](https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-frame-action-bar.png?fit=max\&auto=format\&n=OIImiKPshhawqFXK\&q=85\&s=c767372a08966097abccb48bf11591c7)

A Design frame's action bar: Build…, Focus, and more options.

The action cluster compresses to icons at narrow widths and reveals labels as the frame gets wider. The full set, in left-to-right order:

| Action | What it does |
| - | - |
| Export | Downloads the frame as a PNG. See [Export a frame as PNG](https://docs.replit.com/design/canvas.md#export-a-frame-as-png). |
| Build… | Opens a menu listing every Artifact in the project — choose one to apply the design to it, or choose **Build this design** to create a new Artifact. Design frames only. See [Build](#build). |
| Focus | Enters focus mode, expanding the frame as the main view. |
| More (…) | Additional frame actions. Copy, duplicate, reorder, and export also live in the board's [right-click menu](https://docs.replit.com/design/canvas.md#right-click-menu). |

App frames (Website, Slides, Mobile app) show Focus and more options; Design frames add Build… before them. To branch new directions from a selected frame, follow its [suggestions](https://docs.replit.com/design/explore-suggestions.md).

Selecting a frame also attaches it to the next Agent chat message as a snapshot — see [What lives on the canvas](https://docs.replit.com/design/canvas.md#what-lives-on-the-canvas).

> [!NOTE]
>
> The action bar respects **Read-only mode**. When Canvas is locked inside a background-task context, the iteration actions hide and only Focus remains.

### Media frames

Image, Video, and Vector graphic frames show a small floating action bar above the frame. All three kinds share:

* **Replace media**: upload a new file to swap into the frame, keeping its position and size on Canvas.
* **Download**: save the media file to your computer.
* **Alt text**: add alternative text for accessibility and so Agent has more context when the frame is referenced.

![A selected video frame of a blue supercar on Canvas with its floating action bar above, showing Replace media, Download (with a tooltip reading 'Download original'), and Alt text controls.](https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-frame-video-actions.png?fit=max\&auto=format\&n=OIImiKPshhawqFXK\&q=85\&s=dde933bc1e78e6cc413a9dd15f73fc2e)

A video frame's action bar: Replace media, Download, and Alt text.

Image frames add two more controls:

* **Crop**: trim the image directly on Canvas.
* **Generate video**: generate a video clip from the image.

![A selected image frame of a yellow supercar on Canvas with its floating action bar above, showing Replace media, Crop, Download, Alt text, and Generate video controls.](https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-frame-image-actions.png?fit=max\&auto=format\&n=OIImiKPshhawqFXK\&q=85\&s=95c35379724d57a518efa0578fe0183c)

An image frame's action bar adds Crop and Generate video.

## Explore new directions

Selecting a frame surfaces [suggestions](https://docs.replit.com/design/explore-suggestions.md) beside it: one-click directions grounded in what you're looking at, such as a different layout, a new vibe, or a page your design implies. Each one generates as a new frame alongside the source, so the original stays untouched and you can compare.

![A selected Website frame showing an APEX X1 supercar hero, with a Suggested next steps panel beside it offering suggestion chips such as Explore different approaches, Try different layouts, Explore different vibes, and Surprise me](https://mintcdn.com/replit/9Q_lVrxG2Dh35jz1/images/design/replit-design/ambient-iq.png?fit=max\&auto=format\&n=9Q_lVrxG2Dh35jz1\&q=85\&s=7f39fec76cde3f60e3a20e6c5a13d8db)

## Build

The **Build…** menu on a selected Design frame graduates the design into a live, running app. The same menu also covers applying the design to an Artifact that already exists.

![The Build menu open on a selected Design frame (APEX X1 Exact Replica) with the header 'Build or apply your designs', showing 'Build this design', which creates a new artifact, and 'Apply to an existing creation' listing the project's APEX X1 Design System and its Scroll Hero website](https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-build-menu.png?fit=max\&auto=format\&n=OIImiKPshhawqFXK\&q=85\&s=494228a2a81e9f943376d78e77b96417)

### Build this design

Picking **Build this design** in the menu starts a new Artifact from the selected Design frame. The new Artifact lands in the project's artifact list and becomes a live, running app. Build requires Core or Pro.

### Apply to an existing Artifact

The Build… menu lists every Artifact in the project. Picking one applies the selected Design's changes to that Artifact — Agent rewrites the Artifact's code to match the design, leaving the Design frame on the Canvas for reference.

## Focus mode

Focus mode lets you work with a selected frame full-size while staying in Design.

**1. Choose Focus on a frame**

Select a frame, then choose **Focus** in its action bar.

![A selected Design frame on Canvas with the Focus action highlighted in the frame action bar.](https://mintcdn.com/replit/0WSH0CZtbcWq7rzd/images/design/replit-design/focus-before.png?fit=max\&auto=format\&n=0WSH0CZtbcWq7rzd\&q=85\&s=90cf0b08e2ca6d5db6a561daff8bde3a)

The Focus action in a selected frame's action bar.

**2. Work at full size**

The frame fills the view, so you can work on it up close without the rest of the board.

![Focus mode showing a Design frame filling the view and an Exit focus button at the top of the board.](https://mintcdn.com/replit/0WSH0CZtbcWq7rzd/images/design/replit-design/focus-mode.png?fit=max\&auto=format\&n=0WSH0CZtbcWq7rzd\&q=85\&s=045be2bf21cc136b73d93ff1c2d32513)

Focus mode

**3. Return to the canvas**

Select **Exit focus** at the top of the board to go back to the canvas.

## Related pages

* [Canvas](https://docs.replit.com/design/canvas.md) — overview and anatomy.
* [Toolbar](https://docs.replit.com/design/toolbar.md) — the floating toolbar; Generate creates new frames.
* [Elements](https://docs.replit.com/design/elements.md) — the individual pieces inside a frame.
* [Visual Editor](https://docs.replit.com/design/visual-editor.md) — element-level edits inside a focused frame.
