The canvas
A canvas has three regions:
- Left sidebar (⌘ B): the canvas’s pages, and the current page’s layers: its groups, frames and documents.
- The canvas itself: an infinite surface of frames and documents, with the toolbar at the bottom center.
- Agent panel (⌘ I): the Coordinator, or chat and terminals for the selected chat. Its Chats button lists every chat (see The Chats menu).
The shortcuts hide and show the side panels. While one is hidden, Show sidebar at the top left or Show chat at the top right brings it back.
⌘ . hides both panels at once, or brings them back. Drag a panel’s edge to resize it; the layout is remembered.
Moving around
The zoom percentage at the top right opens the zoom menu: Zoom in, Zoom out, Zoom to fit, Zoom to 50%, Zoom to 100% and Zoom to 200%. Zoom runs from 2% to 1600%. ⌘ = and ⌘ - step through set stops (2%, 5%, 10%, 25%, 50%, 75%, 100%, 150%, 200%, 300%, 400%, 600%, 800%, 1200%, 1600%). Zoom to fit, and double-clicking a layer to zoom to it, stop at 500%, so a small layer doesn’t fill the screen. Your view of each page is your own and is saved with the canvas, so you come back to where you left off, on any device and in the Mac app too.
Zoomed past 400%, a fine pixel grid fades in over the canvas, one line at each pixel’s edge, so you can see exactly where a page’s pixels land. It’s at full strength from 800%.
The names above frames, mockups and documents stay the same size at every zoom. As you zoom out, a name is cut short to its layer’s width, and hides once the layer is less than 64px wide on screen, so a phone frame’s name goes before a desktop frame’s, and layers of the same size always agree. A group’s name goes with its first layer’s.
The top bar
The pill at the top left shows where the canvas lives: All files or its folder, then the canvas name. Double-click the name to rename it. The … menu has Rename, Settings (the canvas’s repositories, memory, files and skills), Keyboard shortcuts (also ?) and Delete. On a canvas shared with you, only the owner can rename it, so the menu has Settings, Keyboard shortcuts and Leave.

The top right holds the zoom menu. On the hosted app it also shows the comment count, who else is here, and Share. See Sharing & collaboration.
Tools
The toolbar at the bottom holds the drawing tools. Exactly one is active at a time. Pressing a tool’s key again returns to Select.
While the Frame or Document tool is active, every group shows an empty outlined slot at its end. Click it to add the new layer to that group. Adding a layer, by clicking, dragging or using a slot, selects it and returns to Select.

A canvas with nothing on it lists Add a frame, Add a mockup and Add a document with their keys, and names the repositories its frames preview. On a canvas with no repository yet, Add a frame is off and Add a repository sits under the three.
Selecting
- Click a layer’s title bar to select it. Shift-click adds to or removes from the selection.
- Drag on empty canvas to draw a selection marquee.
- Clicking a group’s label selects the whole group.
- Delete or Backspace deletes the selection, and the next layer is selected so you can keep going.
- ⌘ D duplicates the selected frames and mockups, adding each copy at the end of its group and selecting the copies.
- With more than one thing selected, groups included, toolbars and menus hide so nothing acts on just one of them.
- Esc backs out one step at a time: it closes whatever is open (editing, a tool, interact mode), then clears the selection.
Layer menus
Each frame, mockup, document and group has one menu, and it’s the same wherever you open it: … on its row in the layers list, … at the end of the toolbar under a selected frame or mockup, or … after the name of a selected document or group. Its tooltip names the object: Frame options, Mockup options, Document options, Group options. It holds, as they apply:
- Rename and Duplicate. A document’s or mockup’s Duplicate adds another view of the same file; Duplicate as new file makes a copy.
- Device size and Fit to content (frames and mockups).
- A frame’s Preview and Chat submenus, which split its chat menu in two.
- Delete for a frame or group. A document or mockup has Remove from canvas, which takes away only that view, and Delete file, which deletes it and every view of it (see Documents).
Groups
Layers on the canvas always live in groups: rows of frames, documents and mockups laid out left to right with an even gap. Groups keep related screens together, such as a page’s desktop and mobile versions or the steps of a signup flow.
- Move a group by dragging any member’s title bar or the group label. Edges and centers snap to nearby groups, with guide lines.
- Merge groups by dragging one group onto the end of another; the target lights up. Hold ⌘ to move without merging.
- Reorder within a group by selecting the group, then dragging a member along the row. Hold ⌘ while dragging to pull it out into a new group.
- Change spacing by selecting the group and dragging the handles between members.
- Rename a group by double-clicking its label, or from its … menu in the sidebar.
While you move, reorder or resize a layer, its floating toolbar hides and comes back when you let go. It also hides while the whole layer is panned or zoomed out of view.
A group disappears when its last member is removed.
A group’s chat
When every frame in a group shows the same chat, as the screens of one flow do, the group names it after the group’s name: its state icon (a spinner while it sets up, moving dots while its agent works), its title, and its pull request when there’s room. Its frames leave the chat off their own titles; to show one of them from another chat, hover the frame’s name and click Choose chat after it.
When the frames show different chats, as parallel explorations do, the group names none, and each frame’s title ends with its own chat. Switching one frame to another chat turns a flow into such a group; switching it back turns it into a flow again. To put every frame in such a group on one chat, hover the group’s name and click Choose chat after it. A group with a single frame has no group label, so that frame’s title names the chat instead.
To show a flow from another chat, click the group’s chat and pick one from the list (for a group named Checkout, it reads Show Checkout from…). Every frame in the group moves, each keeping its route, state and size. Documents and mockups in the group are unaffected. The switch is one undo step, and everyone on the canvas sees it at once.
Only frames decide a group’s chat: documents and mockups don’t count, so a group without frames names no chat and has nothing to switch.
A group whose frames have no chat yet shows Choose a chat after its name instead, and its frames show No chat, with Start a chat to build something new in them, until you pick. Picking one sets the group and all of its frames. Once some frames have a chat and others don’t, each frame offers its own list. A group of documents only has no chat: when its last frame is moved out, split off or deleted, the group drops its chat, and the next frame to join sets it.
A frame’s status (No chat, Setting up the code, a mockup’s Sketching) stays the same size on screen at every zoom. When the frame is too small on screen to fit all of it, the description goes first, then the buttons, then the title, leaving just the icon. While Start a chat is open on a frame, the frame dims behind it.
Pages
A canvas holds one or more pages, like the pages of a Figma file, so one project can show different things without crowding one surface. Pages split the canvas’s layers and nothing else: its repositories, memory, files, skills, chats and Coordinator are shared by every page. Every canvas starts with “Page 1”, and a canvas made before pages has all its content there.

- Pages, at the top of the sidebar, lists every page. Click one to switch to it: the canvas and the layers list show only that page’s layers.
- + adds “Page 2” (and so on), switches to it and opens its name to rename. Type a name and press Enter. A new page starts empty.
- Frames, mockups and documents you add land on the page you’re on. So do the mockups and documents a chat makes for you, unless you name another page (“put it on Explorations”). Chats don’t add, rename or reorder pages themselves: ask one to and it asks the Coordinator, which can.
- Everyone has their own view of each page. Switch back to a page and you’re where you left it; a page you haven’t been on yet opens fitted to its content. The canvas opens on the page you were on last, and the first time, on the first page.
- Layers on other pages aren’t drawn, so a big canvas stays quick. Their chats and previews keep running.
- Clicking a frame, mockup or document named in chat (a mention in a message you sent, or one the Coordinator links in its reply) switches to the page it’s on and shows it there.
- Double-click a page to rename it. Drag pages to reorder them.
- A page’s … has Rename, Duplicate and Delete. Duplicate copies the page and every layer on it just below.
- The canvas’s address names the page you’re on, so copying it links straight to that page.
- Delete removes the page and its layers at once, with no confirm; ⌘ Z brings them back. Anyone on a deleted page moves to the page above it. Chats whose frames were on it keep running. A canvas’s last page can’t be deleted.
- Drag the line between the pages and the layers to give either more room.
- Click Pages to fold the list away. Folded, the heading shows the page you’re on; click it to open the list again. Your browser remembers which way you left it.
- In a shared canvas, a page’s row shows the avatars of the people on it, and following someone takes you to their page (see Seeing each other).
- The canvas’s card on the home screen shows the first page, whichever page you’re on.
To move a layer or a group to another page, open its ⋯ menu and choose Move to page, or drag its row in the layers list onto the page’s name. It lands to the right of what’s already on that page. A layer moved on its own gets a group of its own there. You can also ask the Coordinator to make pages and move things onto them.

With the sidebar hidden (⌘ B), the breadcrumb at the top left shows the page you’re on after the canvas name. Click it for a menu of every page, with the current one checked: pick one to switch to it, or choose New page to add the next “Page N” and switch to it.

The layers list
The sidebar’s layer list mirrors the current page of the canvas. Groups with several members appear as folders. A flow’s row ends with its chat (state icon and title, with its pull request at the row’s end), and its frame rows show just their names. In a group whose frames differ, and in single-frame groups, each frame row ends with its own chat instead.
- Click to select; Shift-click to add to the selection.
- Double-click to zoom to it.
- Drag rows to reorder, move a layer into another group, or drop it between groups to start a new one.
- … opens the layer’s menu, the same one as on the canvas. A delete happens at once; ⌘ Z brings it back.
Undo
⌘ Z and ⌘ ⇧ Z undo and redo your own canvas changes: moving, resizing, adding, deleting and renaming frames, documents and groups, and adding, renaming, reordering, duplicating and deleting pages. A frame’s page, its route and scroll, isn’t part of undo. Your ⌘Z never undoes someone else’s changes or the Coordinator’s.
Deleting a frame, document or group happens at once, whether from the layers list, the frame toolbar or the Delete key, with no confirm and no toast; ⌘ Z brings it back. For a document or mockup, Delete removes only that view, and Delete file deletes the file with every view of it, all brought back by one ⌘ Z. Everyone on the canvas sees the delete, and the undo. Deleting a chat or a repository still asks first, because undo can’t bring those back.
Undo covers the canvas layout only. It doesn’t touch code: to reverse something the agent changed, ask it, or use git.




