> ## 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.

<Frame>
  <img src="https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-overview.png?fit=max&auto=format&n=OIImiKPshhawqFXK&q=85&s=5cd2330c89bbdedfb249151ee582f070" alt="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" width="2000" height="1255" data-path="images/replitai/canvas-overview.png" />
</Frame>

## 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.
</Note>

## 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.

<Frame caption="A Design frame's action bar: Build…, Focus, and more options.">
  <img src="https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-frame-action-bar.png?fit=max&auto=format&n=OIImiKPshhawqFXK&q=85&s=c767372a08966097abccb48bf11591c7" alt="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" width="2000" height="1290" data-path="images/replitai/canvas-frame-action-bar.png" />
</Frame>

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](/design/canvas#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](/design/canvas#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](/design/explore-suggestions).

Selecting a frame also attaches it to the next Agent chat message as a snapshot — see [What lives on the canvas](/design/canvas#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.
</Note>

### 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.

<Frame caption="A video frame's action bar: Replace media, Download, and Alt text.">
  <img src="https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-frame-video-actions.png?fit=max&auto=format&n=OIImiKPshhawqFXK&q=85&s=dde933bc1e78e6cc413a9dd15f73fc2e" alt="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." width="2000" height="1252" data-path="images/replitai/canvas-frame-video-actions.png" />
</Frame>

Image frames add two more controls:

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

<Frame caption="An image frame's action bar adds Crop and Generate video.">
  <img src="https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-frame-image-actions.png?fit=max&auto=format&n=OIImiKPshhawqFXK&q=85&s=95c35379724d57a518efa0578fe0183c" alt="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." width="1600" height="1002" data-path="images/replitai/canvas-frame-image-actions.png" />
</Frame>

## Explore new directions

Selecting a frame surfaces [suggestions](/design/explore-suggestions) 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.

<Frame>
  <img src="https://mintcdn.com/replit/9Q_lVrxG2Dh35jz1/images/design/replit-design/ambient-iq.png?fit=max&auto=format&n=9Q_lVrxG2Dh35jz1&q=85&s=7f39fec76cde3f60e3a20e6c5a13d8db" alt="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" width="2000" height="1254" data-path="images/design/replit-design/ambient-iq.png" />
</Frame>

## 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.

<Frame>
  <img src="https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-build-menu.png?fit=max&auto=format&n=OIImiKPshhawqFXK&q=85&s=494228a2a81e9f943376d78e77b96417" alt="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" width="2000" height="1153" data-path="images/replitai/canvas-build-menu.png" />
</Frame>

### 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

Focus zooms in on the selected frame so it fills the view, letting you work with it up close without the rest of the board. Select **Focus** in the action bar to enter it, and **Exit focus** at the top of the board to return to the canvas.

<Frame>
  <img src="https://mintcdn.com/replit/OIImiKPshhawqFXK/images/replitai/canvas-focus.png?fit=max&auto=format&n=OIImiKPshhawqFXK&q=85&s=b7dedc5039223621221959900bb8e603" alt="A Website frame in focus mode filling the view with the Velocity supercar rental home page, and an Exit focus button at the top of the board." width="2000" height="1252" data-path="images/replitai/canvas-focus.png" />
</Frame>

## Related pages

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