Documentation
The editor
Views, selecting and arranging, the element kinds, inspector and layers, the context menu, copy and paste, locking, variants and undo.
What you see: the four pickers
The pickers in the top bar decide what the centre view shows and where your edits go:
| Picker | Meaning |
|---|---|
| Canvas | which canvas you design (e.g. phone, mac) |
| Target | which output you look at – size, frames, gaps (e.g. ios-iphone-69 (1320×2868)) |
| Language | which language’s texts and screenshots are shown and edited |
| Variant | which layout: the target’s own variant, the Base layout, or another variant |
Each picker ends with a “+” entry: New canvas…, Add target…, Add language…, New variant….
The Variant picker only changes what you look at and edit – which variant a target exports is set in the target itself (see Variants).
Views
Switch in the bottom bar:
- Canvas – the whole row of pages with hatched gaps; this is where you edit. A dashed rectangle shows a target’s safe area, if it has one.
- Pages – each output image of the target as it will be exported (two pages side by side for grouped targets, the region for banners).
- Store gallery – the images as the store shows them, with its gaps and rounded corners. Banners have no gallery.
- All languages – every language as a row, to compare translations; overflowing texts are marked. Click an image to open it on the canvas.
Zoom and pan work the same in every view: scroll to move (Shift
- scroll sideways), ⌘/Ctrl + scroll or pinch to zoom around the pointer, drag on empty space (or Space + drag, or the middle mouse button) to pan. ⌘+ / ⌘− zoom, ⌘0 fits, ⌘1 shows actual size (one export pixel per screen pixel). After Fit the view stays fitted when you resize the window, until you zoom or pan yourself. Scrollbars appear when the content doesn’t fit.
On Windows and Linux, read ⌘ as Ctrl and ⌥ as Alt throughout this guide.

Elements
Add in the top bar puts a new element on the visible page:
| Kind | What it is |
|---|---|
| Device | a phone, tablet, laptop, desktop, watch or browser window showing a screenshot – see Devices & frames |
| Text | a headline or label; the text itself lives in the translations |
| Image | a logo, badge, illustration – PNG, JPEG or SVG from the project’s assets/ folder |
| Shape | rectangle (with corner radius), ellipse or line, with fill and outline |
| Page background | a fill (colour, gradient or image) for one page, on top of the canvas background |
Groups combine elements so they move, rotate and scale together: ⌘G groups the selection, ⇧⌘G ungroups. A group’s Scale in the inspector resizes everything inside it – positions, sizes, font sizes, outlines, corner radii and shadows – around its pivot (the centre of its members, moved by Pivot). Texts are laid out at the new size, so they stay sharp. Set it in a variant to make a card or ticket smaller for one format with a single change. A scaled group cannot be ungrouped; set its scale back to 100 % first.
Backgrounds that run across all pages belong to the canvas: deselect everything and edit Canvas backgrounds in the inspector.
A page background fills its whole home page, so a click on the page selects the element in front of it, not the background. Select it by double-clicking an empty spot of the page, with right-click → Select background “…”, in Layers, or in the canvas settings (nothing selected) under Page backgrounds, which also has Add page background. The inspector then edits its Home page, Fill (colour, gradient or image), Opacity, Layer (z), Clip and visibility.
Selecting
- Click selects an element (a group as a whole).
- Double-click selects the element inside its group – on a text it opens the text for editing; on an empty spot of a page it selects the page’s background element.
- ⌘ + click selects the element under the pointer directly, even inside a group.
- Shift + click adds to or removes from the selection.
- Shift + drag on empty space draws a selection frame (adds).
- ⌘A selects all (except locked elements), Esc clears the selection.
Moving and arranging
- Drag to move. Elements snap to page edges, centres and other elements; hold ⌥ to switch snapping off, Shift to move only horizontally or vertically.
- Resize with the handles; Shift keeps the aspect ratio (not for texts).
- Rotate with the handle above the selection; it snaps at 0°, ±5°, ±15°, ±45° and ±90°, Shift rotates freely in 0.1° steps. Positive angles turn clockwise.
- Arrow keys nudge by 1 lu, with Shift by 10 lu.
- [ / ] send backward / bring forward, Shift+[ / Shift+] to the back / front.
- ⌘D duplicates, ⌫ or Delete deletes.
When you drag an element onto another page, its home page follows. To keep it (e.g. a phone that spans two pages but belongs to the first), use the lock next to Home page in the inspector.
The context menu

Right-click an element (or press Shift+F10 / the menu key) for: Cut, Copy, Paste, Duplicate, Delete, Bring to front, Bring forward, Send backward, Send to back, Group / Ungroup, Lock / Unlock and Hide. It acts on the whole selection.
Right-click empty space for Paste on page N, Select all on page N, Select all and Fit to window.
Copy and paste
⌘C, ⌘X, ⌘V copy, cut and paste elements – also between canvases of the same project.
- Pasted where the originals still are, the copies move 40 lu down and right (further with every paste).
- Paste on page N keeps the position relative to the page, so you can repeat a layout on another page.
- Copies keep their variant overrides (for variants the canvas has).
- The clipboard belongs to the open project; it is not the system clipboard and is emptied when you close the project.
Lock and hide
- Lock makes an element unclickable on the canvas – clicks and selection frames go through it, so you can work on what’s behind a large shape. The Layers tab shows a lock button that unlocks it. Locking only affects the editor, never the rendered images.
- Hide switches the element off (Visible in the inspector). The Layers tab has an eye button to show it again.
The inspector

With an element selected, the inspector shows its settings. The most important:
- Layout: Home page, Centre (position of the centre on the home page, in lu), Size, Rotation, Pivot, Anchor.
- Anchor (Top, Bottom, Centre, Stretch) decides what happens when a target’s page is taller or shorter than the canvas page: the element keeps its distance to that edge (Stretch scales with the page). Phones at the bottom of a page → Bottom.
- Appearance: Opacity, Layer (z), Clip (texts are clipped to their Home page by default), Visible, Shown in targets, Shown in languages (e.g. a badge only in the App Store targets).
- Device: Model, Frame, Colour, Orientation, Screenshot (the key), Fit, Shadow … – see Devices & frames. Next to Screenshot, ▾ (⌥ + ↓) lists the keys with a thumbnail: first those with a file for the current language and variant, then the others. To use a new key, just type it into the field.
- Drag a screenshot onto a device: in the Assets tab, drag a
screenshot onto a device on the canvas (it is highlighted while you are
over it). This sets the device’s Screenshot key, as one undo step. Only
the key counts: a file from another language or variant folder sets it
too, and every language shows its own file of that key (or the fallback).
Images from
assets/cannot go into a device. - Text: Key, Text, Style, Box (Margins to the page edges or a Free box), Align, Vertical, Auto-fit (Shrink down to, Maximum lines), Hyphenation, Colour, Font size, Outline, Glow, Shadow. Below, Laid out shows the font size and line count the text actually got, or Text overflows its box.
- Image: Asset (the eye button opens the image preview), Fit, Shadow. Shape: Shape, Radius, Fill, Stroke. Fills can be a colour, a linear or radial gradient, or an image.
Number fields: drag the label sideways to scrub the value (Shift
for bigger steps), ↑/↓ step, Enter applies,
Esc discards. Colours accept #RRGGBB, #RRGGBBAA or a project
colour (@accent).
With nothing selected, the inspector shows the canvas settings: page Aspect and Page height, number of Pages (add or remove at the end), Page ids (they name the exported files), Canvas backgrounds, Page backgrounds and the Variants.
The inspector is wider than before and resizable: drag its left edge (double-click it for the default width). The width is remembered.
Clipping an image to a shape
An image can be cut to the outline of a rectangle (its Radius counts) or ellipse shape on the same canvas – a photo inside a comic panel, a round avatar, a picture in a rounded card. Select the image and pick the shape under Clip to in its Image section; the list shows the rectangles and ellipses of the canvas. The mask follows the shape exactly as it is placed in each target and variant, including rotation and groups.
The shape is still drawn as usual (e.g. the panel’s colour and stroke behind the photo). To use it only as a mask, switch off its Visible: the list then marks it hidden: mask only.
Renaming the shape updates the images clipped to it, and deleting it also
removes their Clip to in the same undo step – nothing is left pointing at
a missing shape. In the project file this is clip_to on the image, see
Elements.
Layers
The Layers tab lists the canvas’s elements in painting order (top = in front). Click to select, Shift + click for a range, ⌘ + click to toggle, ↑/↓ to walk, drag to reorder, double-click / Enter / F2 to rename (the element id). Groups expand and collapse; eye and lock buttons show hidden and locked elements.
Variants
A variant stores per-format differences of a canvas – e.g. the phones a bit lower in the iPad landscape set – as overrides, while texts, screenshots and styles stay shared.
- The Variant picker defaults to the target’s own variant (
… · target). While a variant is shown, the inspector says Edits become overrides of …: every move, resize or change goes into that variant only. Overridden fields are marked purple, with Reset to base per field and Reset all. - Switch the picker to Base to edit the shared layout.
- New variant… (Variant picker, canvas settings or Canvases & targets): name, Based on (the base layout or a copy of another variant), Content scale (scales devices and images in this variant) and Shown by (targets that use it from now on).
Which variant a target exports is set in the target (Canvases & targets → target → Variant). See Targets & store formats.
Canvases
The Canvases tab lists the project’s canvases with their pages and targets; New canvas… and Manage… open Canvases & targets (also in the ☰ menu). There you can:
- create a canvas – Empty, Headline + device (a headline and a device on every page) or a Copy of a canvas – with a page format from a store preset and, in the same step, the matching target (Also add this target);
- rename, duplicate or remove a canvas (removing also removes its targets);
- insert canvases From template and Save as template… – see Templates;
- add store banners with Banner from this canvas.
A canvas is only shown and exported through its targets – a new canvas needs at least one.
Panoramas across pages
A motif that runs through the whole set – a sky, a landscape, a ribbon – is drawn once on the canvas, not cut into one picture per page. The canvas has the store’s gaps, and whatever lies in a gap is simply left out of the images, so a continuous motif lines up across every seam in the store. Simplest first:
- One image behind all pages: deselect everything, then under
Canvas backgrounds add a background and set its Fill type to
Image, with the image from
assets/and a Fit (Cover fills and crops). It spans all pages and gaps of each target. Good for skies, gradients, textures and scenery without details that must sit at an exact spot of a page. - One wide image element: Add → Image with the panorama, Clip None (the default for images), Anchor Stretch, and a Size wide enough for all pages plus the gaps (3 pages: a bit more than 3000 lu). It continues behind every gap; you control its layer (z) and can change it in a variant (e.g. another picture for a landscape set).
- Bridging pieces for exact motifs at one seam – a phone lying across the border, a ribbon, a card: one element on the left page with Clip None that reaches into the next page. Its position belongs to its home page, so it stays continuous behind the gap whatever the gap. Combine it with a page background per page for different colours per page.
Cut a motif into one image per page only when the pages really differ (for example a separate composition for an iPad landscape set). Those slices no longer join at the seams, so let a seam fall on a calm area or cover it with a bridging piece.
The App Store and Google Play have different gaps (and so may two sizes
of one store), so a motif lands a little differently on the pages of each
target. Don’t compute gaps and don’t cut images to match them: pick each
target and look at it in the Store gallery view. Validation
reports a shape built as two halves at a border (seam_split) and a
bridging piece that covers something on the next page (seam_overlap).
Background: Gaps like in the store.
Undo and history
Everything you do is one undo step: ⌘Z undoes, ⇧⌘Z or ⌘Y redoes. The undo button’s tooltip names the step. Changes are saved to disk immediately – there is no Save.
The history also contains edits by an AI assistant, labelled
with its name (“Claude Desktop: Move title”). Changes from outside (text
editor, git checkout) reload the project.
Validation

The badge in the top bar checks the current target and language continuously:
OK, or the number of errors and warnings. Click it for the list – filter by
level or code, switch between languages, Show on the canvas jumps to the
element. Preview mode treats missing screenshots as warnings while you
design (export still checks them strictly). The check also looks at the
rendered pages: text contrast against what is really behind it, text touching
devices, covered or cut screen top bars, overlaps across page borders, the
store’s rounded corners. Common findings, and how to mark a deliberate one
with allow, are explained in Troubleshooting.
Project settings and app settings
| Project settings (☰ → Project settings…) | App settings (☰ → App settings…, ⌘,) | |
|---|---|---|
| Belongs to | the project folder – travels with it, shared via Git | your computer – all projects |
| Contains | General (name, default Frame style), Languages, Styles, Fonts, Stores | interface language, defaults for new projects, system fonts, Frame packages, store accounts, AI assistants (MCP), Updates, Command line tool |
Help in the app

The ☰ menu opens from the ☰ button, the app icon or the project name in the top bar (also with Enter/Space when focused; arrow keys move through the entries).
- Keyboard & mouse… (☰ → Help, the ? button in the bottom bar, or ?) – every shortcut and gesture. Also on Keyboard & mouse.
- How Vitrine Studio is organised… – the one-screen overview.
- Download Apple Product Bezels (top of the Help menu) opens Apple’s Design Resources page – see Devices & frames.