Documentation
Documentation
What you'll learn
The Vitrine Studio user guide – from the first project to the store upload.
Vitrine Studio turns one layout into every screenshot your store listings need: every device size, every language, App Store and Google Play. This guide shows you how, task by task.
New here? Read How Vitrine Studio works (five minutes), then follow Getting started to make and export your first set.
Using fastlane? See Using with fastlane. Using Claude? See AI assistants (MCP).
How it works
Projects, canvases and pages, gaps, home pages, targets × languages × variants, lu units – the few ideas everything else builds on.
Install & update
Install the app on macOS, Windows or Linux, make the vitrine command available in your terminal, keep it up to date – or build it from source.
Getting started
Create a project from a template, find your way around the window, add your screenshots and headlines, and export your first set.
The editor
Views, selecting and arranging, the element kinds, inspector and layers, the context menu, copy and paste, locking, variants and undo.
Devices & frames
Built-in device frames, Apple Product Bezels you import yourself (and store in a private project for CI), your own frame packs, device swaps per target, foldables and watches.
Targets & store formats
Add store formats from presets, adapt one canvas to other sizes with anchors, grouping and variants, create banners and App Store creatives, and set up watch targets.
Styles & fonts
Colours, text and span styles, shadows; bundled, project and installed fonts; Arabic, Hebrew, Indic, Thai and CJK scripts; outlines and glows.
Languages & translation
Add languages, understand fallbacks, translate in the table or with translators (CSV, XLIFF), fit long texts, use markup and per-language overrides.
Screenshots
Where your app screenshots go, how keys and screenshot variants work, importing whole folders (also fastlane), placeholders and colour profiles.
Export
Export every target × language as PNG or JPEG, in Vitrine Studio's folder layout or fastlane's, with an index.html overview – incrementally, from the app or the command line.
Automation
Run Vitrine Studio without the app: validate, export and upload store screenshots from a CI pipeline, a fastlane lane or your own scripts with the vitrine CLI.
Store upload
Set up an App Store Connect API key and a Google Play service account, link your project, then upload with plan → confirm → upload.
Templates & gallery
Start projects from templates, save your own canvases as templates, insert them into a project, share .vitrine-template files and publish to the gallery.
AI assistants (MCP)
Connect Claude Desktop, Claude Code or any MCP client: the assistant designs, translates, checks and exports in your open project – live in the app, undoable.
CLI reference
Every vitrine command and option: new, validate, render, export, strings, import, frames, fonts, template, gallery, upload, mcp, install-cli.
Project file format
The project folder and every section of project.yaml – languages, styles, canvases, elements, variants, targets, store – plus the translation files, with examples from the Fernwood project.
Troubleshooting & FAQ
Common validation findings and how to fix them, frequent questions, and current limits.
Keyboard & mouse
Every shortcut, mouse gesture and modifier key of the editor.
This guide describes Vitrine Studio 1.0. Found a mistake or a gap? Improve the page on GitHub.