Dokumentation

Vorlagen & Galerie

Was du hier lernst

Projekte aus Vorlagen starten, eigene Leinwände als Vorlage speichern, in ein Projekt einfügen, .vitrine-template-Dateien weitergeben und in der Galerie veröffentlichen.

Eine Vorlage besteht aus einer oder mehreren Leinwänden – z. B. Phone, Tablet und Feature-Grafik als abgestimmtes Set – mit ihren Zielen und Varianten, den Stilen, den Texten in allen Sprachen, Bildern und Schriften. Sie ist eine einzige .vitrine-template-Datei.

Mitgelieferte und eigene Vorlagen

  • Phone – drei Seiten mit je einer Überschrift und einem Phone; Ziele iPhone 6,9″ und 6,3″ (das Set, das Apple verlangt), Google-Play-Phone, die Play-Feature-Grafik und ein Blog-Header. Die Vorgabe.
  • Minimal – eine iPhone-Seite.
  • Deine eigenen Vorlagen – gespeichert, importiert oder heruntergeladen – liegen im App-Datenordner (templates/) und stehen in jedem Projekt zur Verfügung.

Neues Projekt aus einer Vorlage

Startbildschirm → Neues Projekt → eine Vorlagenkarte wählen (oder Datei importieren… für eine .vitrine-template-Datei) → Name, Speicherort, Sprachen → Erstellen. Der Reiter Vorlagen-Galerie zeigt die Online-Galerie (Suche, Filter, Link zur großen Ansicht auf der Website); Herunterladen und erstellen lädt die gewählte Vorlage einmal herunter und behält sie unter Lokale Vorlagen.

Der Reiter Lokale Vorlagen im Dialog Neues Projekt: die mitgelieferten Vorlagen Phone und Minimal, die heruntergeladenen Park Poster, Pop-Art Panels und Synthwave Sunset und Datei importieren. Der Reiter Lokale Vorlagen im Dialog Neues Projekt: die mitgelieferten Vorlagen Phone und Minimal, die heruntergeladenen Park Poster, Pop-Art Panels und Synthwave Sunset und Datei importieren.
Lokale Vorlagen: mitgelieferte, heruntergeladene Galerie-Vorlagen und eigene.
  • Alle Leinwände der Vorlage kommen mit.
  • Texte: Jede deiner Sprachen bekommt den Text der Vorlage in derselben Sprache, sonst in ihrer Basissprache (de-AT ← de), sonst in der Standardsprache der Vorlage – gemeldet als „kopiert, zu übersetzen“.
  • Screenshots bleiben leer. Die Platzhalter-Screens der Vorlage werden nicht kopiert, damit die Prüfung weiter nach deinen echten Screenshots fragt und kein Platzhalter im Store landen kann.
  • Beispiel-Screenshots: Manche Vorlagen bringen eigene Dummy-Screenshots ihres Autors mit, damit du das Design sofort ausprobieren kannst. Sie werden nach screenshots/ kopiert und in screenshots/samples.yaml vermerkt. Die Prüfung zeigt den Hinweis sample_screenshot („durch eigenen ersetzen“), der Export funktioniert, aber ein Store-Upload lehnt jedes Screenshot-Set ab, das noch ein Beispiel enthält. Ersetze eine Datei durch deinen eigenen Screenshot (gleicher Name) – dann ist sie kein Beispiel mehr, sonst ist nichts zu tun.
vitrine new my-app --template phone --lang en --lang de
vitrine new my-app --template ./bold-gradient.vitrine-template

Als Vorlage speichern

Leinwände & Ziele → eine Leinwand → Als Vorlage speichern…: wähle die Leinwände, gib einen Namen (die Id ergibt sich daraus), Beschreibung und Autor an, wähle die Schlagwörter, optional Meine Screenshots als Beispiel-Screenshots mitnehmen und Auch als Datei speichern, um sie weiterzugeben. Erneutes Speichern mit derselben Id ersetzt die Vorlage.

Was hineinkommt:

  • die Leinwände, die Ziele, die sie zeigen, ihre Varianten, alle Stile;
  • nur die Texte, die die Leinwände verwenden, in allen Sprachen;
  • die verwendeten Bilder und Schriften aus dem Ordner fonts/ des Projekts, die ein Stil nennt;
  • nicht deine Screenshots (ersetzt durch erzeugte Platzhalter-Screens im Seitenverhältnis des Geräts) – außer du nimmst sie als Beispiel-Screenshots mit: Dann kommen die Screenshots, die die Leinwände verwenden (PNG/JPEG, höchstens 10 MB und 6000 px je Seite), als JPEG (Qualität 60) neu kodiert hinein, damit die Vorlage klein bleibt (Bilder mit transparenten Pixeln bleiben PNG). Mach das nur mit Screenshots, die dir gehören (z. B. einer Demo-App); in der Galerie werden sie als CC0 veröffentlicht;
  • nicht Store-Einstellungen, Import-Zuordnungen oder importierte Hersteller-Rahmen (Vorschauen nutzen die eingebauten Rahmen).

Schlagwörter stammen aus einer festen Liste in drei Gruppen – keine freien Wörter –, damit die Galerie zuverlässig filtern kann:

GruppeAnzahlWerte
Stil (--style)1–2minimal, bold, playful, elegant, realistic, illustrated, editorial, retro, futuristic, organic
Farbe (--color)1–2light, dark, colorful, pastel, monochrome, gradient, neon, earthy
App-Kategorie (--use)1–3games, productivity, business, finance, health-fitness, sports, education, kids, food-drink, travel, navigation, social, lifestyle, shopping, entertainment, music, photo-video, news, weather, utilities, developer-tools, medical, home-garden, books, events

In der App erscheinen sie mit deutschen Namen (z. B. „Minimalistisch“, „Farbverlauf“, „Gesundheit & Fitness“). Eine lokale Vorlage darf Gruppen leer lassen; die Galerie braucht je Gruppe mindestens eines. Die Geräte (phone, tablet, watch, mac, web, tv, banner) ergeben sich aus den Ausgabezielen – du setzt sie nicht selbst. vitrine template tags listet alles auf.

Schriften: Nur Schriften, die die SIL Open Font License angeben, dürfen in eine Vorlage; andere werden abgelehnt („darf nicht weitergegeben werden“ oder „Lizenz unklar“). Die Lizenzdatei wird übernommen oder erzeugt (fonts/<name>-OFL.txt). Mitgelieferte Schriften brauchen nichts.

Auf der Kommandozeile speichert vitrine template save alle Leinwände des Projekts. Willst du nur einige, nenne sie mit --canvas – einmal pro Leinwand (--canvas phone --canvas tablet). Die Schlagwörter setzt du mit --style, --color und --use; jede Option darf mehrfach vorkommen oder mehrere Werte mit Komma nehmen (--color gradient --color dark ist dasselbe wie --color gradient,dark). Freie Schlagwörter (--tag) gibt es nicht mehr – nur die Werte aus der Tabelle oben.

# alle Leinwände des Projekts
vitrine template save --name "Bold gradient" \
  --style bold --color gradient --color dark --use travel -o bold.vitrine-template
# nur die Leinwände phone und tablet
vitrine template save --name "Calm set" --canvas phone --canvas tablet \
  --style minimal --color light,pastel --use productivity,health-fitness
# mit eigenen Screenshots als Beispiele
vitrine template save --name "Demo set" --style minimal --color light --use productivity \
  --sample-screenshots
vitrine template tags                      # alle Schlagwörter
Der Dialog Als Vorlage speichern: Name, Id, Beschreibung, Autor, Stil-, Farb- und Kategorie-Tags, die Leinwände und die Optionen für Beispiel-Screenshots, Schriften und die .vitrine-template-Datei. Der Dialog Als Vorlage speichern: Name, Id, Beschreibung, Autor, Stil-, Farb- und Kategorie-Tags, die Leinwände und die Optionen für Beispiel-Screenshots, Schriften und die .vitrine-template-Datei.
Als Vorlage speichern… (☰-Menü) mit Tags für die Galerie; alle Leinwände sind ausgewählt.

Aus Vorlage einfügen

Leinwände einer Vorlage in ein bestehendes Projekt übernehmen: Leinwände & Ziele → Neue Leinwand … → Aus Vorlage. Wähle die Vorlage und ihre Leinwände; der Dialog zeigt, was passieren wird. Das Ganze ist ein Rückgängig-Schritt.

  • Leinwand- und Ziel-Ids, die es schon gibt, bekommen -2 (ios-iphone-69 → ios-iphone-69-2), Element-Ids die nächste freie Nummer.
  • Gleiche Stilnamen: Eine Farbe oder ein Stil, den das Projekt anders definiert, wird entweder getrennt behalten (Beide behalten – umbenannt, z. B. accent-2; die Vorgabe) oder durch den des Projekts ersetzt (Die dieses Projekts). Gleiche Stile werden geteilt. Der Rahmenstil deines Projekts bleibt.
  • Texte mit gleichem Schlüssel und gleichem Inhalt werden geteilt; andere werden zu <vorlage>.<schlüssel>.
  • Bilder und Schriften werden kopiert; gleiche Dateien werden wiederverwendet.
vitrine template insert bold-gradient --canvas phone --styles use-project --dry-run

Vorlagen verwalten

vitrine template list
vitrine template import bold.vitrine-template [--replace]
vitrine template export bold-gradient -o bold.vitrine-template
vitrine template remove bold-gradient          # mitgelieferte Vorlagen lassen sich nicht entfernen

Jede Vorlagendatei wird vor der Verwendung geprüft: Größengrenzen (250 MB gepackt, 500 MB entpackt; der Galerie-Server hat ein eigenes Upload-Limit, standardmäßig 50 MB), nur bekannte Dateiarten, anhand des Inhalts geprüft, keine Pfade außerhalb des Pakets oder versteckte Dateien, SVG ohne Skripte oder externe Links, und das enthaltene Projekt muss sich laden und prüfen lassen.

Lizenz

Vorlagen stehen unter CC0 (gemeinfrei) – jeder darf sie für alles verwenden. Enthaltene Schriften behalten ihre OFL-Lizenz. Speichere Vorlagen nur aus Material, das du so weitergeben darfst.

  • Durchsuchen und Herunterladen brauchen kein Konto.
  • Veröffentlichen braucht eine GitHub-Anmeldung und vollständige Schlagwörter. Der Server prüft jeden Upload noch einmal, ersetzt alle Screenshots durch eigene Platzhalter, rendert die Vorschauen selbst und stellt die Vorlage zur Moderation ein. Vorlagen des offiziellen Kontos sind als official markiert.
  • Beispiel-Screenshots bleiben nur in der Vorlage, wenn du bestätigst, dass es deine eigenen sind und sie als CC0 veröffentlicht werden dürfen (--confirm-own-screenshots); ohne Bestätigung ersetzt der Server sie durch Platzhalter.
  • Die Galerie filtert nach Stil, Farbe, App-Kategorie und Gerät (vitrine gallery list --style bold --use games,kids --devices phone).
vitrine gallery list --query garden              # freigegebene Vorlagen
vitrine gallery download bold-gradient           # → bold-gradient.vitrine-template
vitrine template import bold-gradient.vitrine-template

vitrine gallery login                            # GitHub-Anmeldung per Gerätecode
vitrine template export bold-gradient -o bold.vitrine-template
vitrine gallery upload bold.vitrine-template     # Status „pending“ bis zur Freigabe
vitrine gallery logout

Viele Vorlagen auf einmal: vitrine gallery upload nimmt mehrere Dateien. --dry-run führt alle lokalen Prüfungen aus (Paket, Schlagwörter, Beispiel-Screenshots) und zeigt eine Übersichtstabelle, ohne etwas zu senden; ein echter Lauf macht nach einer fehlerhaften Datei weiter und endet mit derselben Übersicht (Exit-Code 1, wenn eine Datei scheiterte).

vitrine gallery upload dist/*.vitrine-template --dry-run --confirm-own-screenshots
vitrine gallery upload dist/*.vitrine-template --confirm-own-screenshots

gallery login zeigt einen Code und die Adresse https://github.com/login/device; gib den Code dort ein. Es werden keine GitHub-Berechtigungen angefragt – gelesen werden nur dein öffentlicher Benutzername und deine Id. Die Sitzung (90 Tage) liegt im Schlüsselbund des Systems. Deine Vorlagen bleiben deine, auch wenn du dein GitHub-Konto umbenennst. Eine Id hochzuladen, die jemand anderem gehört, scheitert mit „id taken“; dieselbe Version zweimal hochzuladen fordert dich auf, die Version zu erhöhen (template save --version).

Diese Seite auf GitHub verbessern