Dokumentation

So funktioniert Vitrine Studio

Was du hier lernst

Projekte, Leinwände und Seiten, Lücken, Heimatseiten, Ziele × Sprachen × Varianten, die Einheit lu – die wenigen Ideen, auf denen alles aufbaut.

Store-Screenshots vervielfachen sich schnell: mehrere Seiten, mehrere Geräteklassen, mehrere Sprachen, zwei Stores. Vitrine Studio baut auf einer Idee auf: Du gestaltest einmal, und die App rendert jedes Bild, das du brauchst.

Projekt ─┬─ Leinwand "phone"  ── Seiten 1 … 6, Hintergründe, Geräte, Texte
         └─ Leinwand "mac"    ── Seiten 1 … 4, Hintergründe, Geräte, Texte

Ziel × Sprache × Variante  →  fertige Bilder
(iPhone 6,9″, Google Play Phone, iPad 13″ …) × (en, de, fr …)

Ein Projekt ist ein Ordner

Ein Projekt ist ein ganz normaler Ordner: project.yaml (das Layout), eine Textdatei pro Sprache in i18n/, deine App-Screenshots in screenshots/, dazu optional Bilder, Schriften und Frames. Kein Konto, keine Cloud, nichts Verstecktes – du kannst es in Git verwalten, Diffs ansehen und reviewen. Jede Änderung in der App wird sofort gespeichert; einen Speichern-Befehl gibt es nicht. Ändern sich die Dateien auf der Platte (Texteditor, git checkout, ein KI-Assistent), lädt das offene Projekt live neu.

Details: Projektdateiformat.

Leinwand und Seiten

Eine Leinwand ist eine Reihe von Seiten, die du als ein Bild gestaltest. Jede Seite wird zu einem Store-Screenshot. Weil es ein Bild ist,

  • kann ein Hintergrund durchgehend über alle Seiten laufen (die Hintergründe der Leinwand sind Ebenen über der ganzen Leinwand; für eine Farbe oder ein Foto pro Seite legst du auf jede Seite ein Hintergrund-Element);
  • kann ein Gerät über der Grenze zwischen zwei Seiten liegen und existiert trotzdem nur einmal – im Store sieht es aus wie ein Smartphone über zwei Screenshots;
  • siehst du beim Arbeiten das ganze Set so, wie es im Store erscheint.

Ein Projekt kann mehrere Leinwände haben – zum Beispiel phone, tablet und mac –, jede mit ihrem eigenen Seitenformat.

Eine Leinwand mit sechs Smartphone-Seiten einer Musik-App: ein durchgehender Synthwave-Himmel mit Sonne, Neon-Gitterboden und Palmen läuft über alle Seiten; schraffierte Streifen markieren die Lücken zwischen den Seiten.
Die Phone-Leinwand der Vorlage Synthwave Sunset: sechs Seiten, ein durchgehender Hintergrund. Die schraffierten Streifen sind die Store-Lücken.

Lücken wie im Store

App Store und Google Play zeigen Screenshots nebeneinander mit einer kleinen Lücke dazwischen. Die Leinwand hat dieselben Lücken (im Editor schraffiert), damit ein Gerät oder eine Linie, die über eine Seitengrenze geht, im Store richtig weiterläuft. Was in einer Lücke liegt, gehört einfach zu keinem exportierten Bild. Wie du ein Motiv baust, das über mehrere Seiten läuft: Panoramen über mehrere Seiten.

Die Lückengrößen kommen aus dem Galerie-Profil des Ziels. Die Werte für die Store-Websites sind gemessen; die für die nativen Store-Apps sind noch Schätzungen.

Heimatseite

Jedes Element (Gerät, Text, Bild, Form) gehört zu einer Heimatseite. Seine Position bezieht sich auf diese Seite, und es darf in die Nachbarseiten hineinragen. Texte werden standardmäßig auf ihre Heimatseite beschnitten, damit eine Überschrift nie in den nächsten Screenshot rutscht.

Eine Einheit: lu

Eine Seite ist immer 1000 lu (logische Einheiten, „logical units“) breit; ihre Höhe folgt aus dem Seitenverhältnis (eine iPhone-Seite ist etwa 2173 lu hoch). Alle Positionen, Größen, Schriftgrößen und Ränder sind in lu. Deshalb passt ein Layout für jede Exportgröße: Die Pixelgröße kommt erst vom Ziel.

Ziele

Ein Ziel (Ausgabeziel) ist eine Ausgabe: „App Store iPhone 6,9″“, „Google Play Phone“, „iPad 13″ quer“, „Mac App Store“, die Google-Play-Feature-Grafik, ein Blog-Header … Es legt fest, welche Leinwand es zeigt, die Pixelgröße, den Store-Slot, die Geräte-Frames und das Galerie-Profil. Die meisten Ziele kommen aus Presets mit den exakten Store-Größen.

Ein Ziel kann die Leinwand anpassen, ohne sie zu duplizieren:

  • Anderes Seitenverhältnis. Eine Leinwand für das iPhone (etwa 1:2,17) wird auch für Google Play (1:2) gerendert. Elemente halten ihren Abstand zum oberen Rand, zum unteren Rand oder zur Mitte der Seite – je nach ihrem Anker.
  • Gruppieren. Seiten pro Bild: 2 setzt zwei Hochformat-Seiten nebeneinander in ein Querformat-Bild – ein iPad-Querformat-Set aus der Phone-Leinwand. Tablets können natürlich auch eine eigene Leinwand bekommen; das Gruppieren ist nur eine bequeme Abkürzung.
  • Geräte-Tausch. Das Play-Ziel ersetzt die iPhone-Frames durch Android-Frames.
  • Banner. Ein Bild aus einem Ausschnitt der Leinwand, z. B. die Feature-Grafik oder ein Header für einen Blogpost.

Varianten

Manchmal braucht ein Format eine leicht andere Anordnung – im iPad-Querformat-Set sitzt das Smartphone etwas tiefer, das Band ist weniger steil. Eine Variante speichert genau diese Unterschiede (Position, Größe, Drehung, Heimatseite, Sichtbarkeit …) als Overrides. Texte, Screenshots und Stile bleiben gemeinsam. Ein Ziel zeigt eine Variante; alles, was nicht überschrieben ist, kommt aus dem Basis-Layout.

Sprachen

Jedes Ziel wird in jeder Projektsprache gerendert. Texte liegen in einer Datei pro Sprache, Screenshots in einem Ordner pro Sprache. Was fehlt, kommt aus einer Ersatzsprache – fr-CA greift auf fr zurück, am Ende alles auf die Standardsprache –, sodass auch eine halbe Übersetzung oder ein unvollständiges Screenshot-Set gerendert wird. Ein Sprach-Override passt ein Textelement nur für eine Sprache an (eine breitere Box für die lange deutsche Überschrift). Siehe Sprachen & Übersetzung.

Ziele × Sprachen × Varianten = deine Bilder

Zusammengenommen: Du bearbeitest eine Leinwand; jedes Ziel rendert sie in seiner Größe mit seiner Variante, in jeder Sprache. Ein Projekt mit 3 Zielen und 4 Sprachen liefert dir 12 komplette Bildsätze – und wenn du eine Überschrift änderst, ändern sich alle.

Dieselben sechs Seiten als Google-Play-Satz: Android-Smartphones statt iPhones auf dem Synthwave-Hintergrund.
Dieselbe Leinwand als Google-Play-Ziel, gezeigt als Galerie-Vorschau – die Bilder nebeneinander, so wie der Store sie zeigt; deshalb sieht sie anders aus als die Leinwand oben: Der Geräte-Tausch zeichnet Android-Smartphones, die Variante play passt die kürzeren Seiten an.

Ein Renderer für alles

Die Vorschau im Editor, die exportierten Dateien, die Galerie-Vorschauen, der Store-Upload und die Vorschauen für einen KI-Assistenten kommen alle aus demselben Renderer. Was du im Editor siehst, landet genau so im Store.

Drei Arten zu arbeiten

  • Die Desktop-App – der visuelle Editor. Fang hier an.
  • Das Kommandozeilen-Tool vitrine – prüfen, rendern, exportieren, übersetzen, importieren und hochladen aus Skripten und CI. Siehe CLI-Referenz.
  • KI-Assistenten über MCP – Claude und andere Assistenten können im geöffneten Projekt live gestalten, übersetzen, prüfen und exportieren. Siehe KI-Assistenten.

Alle drei arbeiten auf demselben Projektordner und lassen sich beliebig kombinieren.

Diese Seite auf GitHub verbessern