So reichst du eine Vorlage ein

Bevor du beginnst

Du benötigst zwei Dinge, bevor du einreichst.

1. Ein GitHub-Konto. Dein Vorlagen-Repository muss auf GitHub gehostet werden. Wenn du noch kein Konto hast, erstelle zuerst eines.
2. Ein abgeschlossenes Design. Stelle sicher, dass du mit deiner .picopixel-Datei zufrieden bist, bevor du einreichst. Exportiere sie aus der PicoPixel-App und halte sie zum Hinzufügen zu deinem Repo bereit.

Dein GitHub-Repo einrichten

Erstelle ein neues öffentliches GitHub-Repository für deine Vorlageneinreichung. Das Repo sollte drei Dinge enthalten:

1. Deine .picopixel-Datei

Lege deine .picopixel-Design-Datei im Hauptverzeichnis des Repositorys ab. Das ist die Datei, die die Leute herunterladen und in PicoPixel öffnen werden, also stelle sicher, dass es die finale Version ist.

2. Vorschaubilder

Füge alle Bilder hinzu, die du neben deiner Vorlage in der Galerie anzeigen möchtest. Diese helfen den Leuten zu sehen, wie das Design aussieht, bevor sie es herunterladen.

• Lege Bilder im Hauptverzeichnis des Repositorys oder in einem Ordner wie images/ ab.
• Verwende gängige Formate: .png, .jpg oder .webp.
• Füge mindestens einen Screenshot deines Designs in Aktion bei. Mehrere Ansichten oder Bildschirme sind noch besser.
• Halte Bilder in einer vernünftigen Größe – groß genug, um Details zu sehen, aber nicht unnötig riesig.

3. Eine README

Schreibe eine README.md im Hauptverzeichnis des Repositorys. Diese wird als Beschreibung der Vorlage in der Galerie verwendet, behandle sie also als die öffentliche Seite für deine Vorlage.

Eine gute README enthält:

• Was die Vorlage ist – eine kurze Zusammenfassung des Designs und wofür es gedacht ist.
• Zielauflösung und Hardware – das Board oder Display, für das es gebaut wurde, damit die Leute wissen, ob es zu ihrem Setup passt.
• Was enthalten ist – liste die Bildschirme, Widgets und wichtigsten Funktionen auf. Zum Beispiel: „zwei Bildschirme: ein Haupt-Dashboard und eine Einstellungsseite, mit Schiebereglern, Umschaltern und einem Uhr-Widget."
• Urheberangaben – wenn du Drittanbieter-Assets verwendet hast, die du laut Lizenz weitergeben darfst, nenne sie und ihre Quelle.

Hier ist ein minimales Beispiel:

# Weather Dashboard Template

A clean two-screen weather dashboard designed for 320×240 TFT displays.

## What's included

- **Home screen** — current temperature, humidity, and a 3-day forecast row
- **Settings screen** — unit toggle (°C/°F), update interval slider, and Wi-Fi status

## Built for

- 320×240 resolution
- ILI9341 or similar TFT displays

## Credits

Weather icons from [Meteocons](https://bas.dev/work/meteocons) (MIT license).

Das Formular ausfüllen

Sobald dein Repo bereit ist, gehe zum Einreichungsformular.

1. Öffne die PicoPixel-App und melde dich an.
2. Klicke auf dein Konto am unteren Rand der linken Seitenleiste, dann wähle Dein Konto.
3. Öffne in der Seitenleiste deines Kontos Vorlage einreichen.

Das Formular hat drei Felder:

• GitHub-Repo-Link – die URL deines öffentlichen GitHub-Repositories (z. B. https://github.com/deinname/mein-template). Das Repo muss öffentlich sein, damit das Review-Team darauf zugreifen kann. Überprüfe, ob das Repo deine .picopixel-Datei, Bilder und README enthält, bevor du einreichst.
• Autor / Urheberangaben – der Name, der als Ersteller der Vorlage angezeigt werden soll. Füge alle hinzu, die neben dir genannt werden sollen.
• Hinweise (optional) – alles, was das Review-Team wissen sollte und nicht in deiner README steht. Zum Beispiel, wenn bestimmte Bilder nicht in der Galerie-Auflistung verwendet werden sollen, oder wenn es Kontext zum Design gibt, der nicht in die öffentliche Beschreibung gehört.

Wenn alles stimmt, sende das Formular ab.

Rechte und Genehmigungen

Mit deiner Einreichung räumst du Nutzungsrechte ein. Lies die folgenden Bedingungen deshalb vor dem Absenden sorgfältig durch.

Mit der Einreichung erlaubst du PicoPixel, den Inhalt deines Repositories öffentlich in der Community-Vorlagengalerie zu öffnen, herunterzuladen und zu veröffentlichen. Veröffentlichte Vorlagen werden ohne Urheberrechtsbeschränkungen oder Lizenzanforderungen zur Verfügung gestellt, sodass jeder sie frei in seinen eigenen Projekten verwenden kann, auch für kommerzielle Zwecke. Du wirst als Urheber genannt, aber die Vorlage selbst ist für andere frei verwendbar.

Reiche deshalb nur Arbeiten ein, die du zu diesen Bedingungen teilen möchtest. Wenn ein Teil deines Designs ein Asset verwendet, das du nicht erstellt hast – eine Schriftart, ein Icon-Set, ein Bild oder Ähnliches – und du dir nicht sicher bist, ob du es frei und uneingeschränkt teilen kannst, entferne es vor dem Einreichen. Im Zweifel lieber weglassen: Eine Vorlage mit geklärten Rechten ist für andere viel nützlicher als eine, die später entfernt werden muss.

PicoPixel kann Inhalte entfernen, die Rechte Dritter verletzen. Siehe die Nutzungsbedingungen.

Was danach passiert

Nach deiner Einreichung klont das PicoPixel-Team dein Repo und überprüft die Vorlage. Die Überprüfung stellt sicher, dass die .picopixel-Datei korrekt geöffnet wird, dass die Bilder und README angemessen sind und dass die Einreichung den Nutzungsbedingungen entspricht.

Das Team kann sich melden, wenn etwas geklärt oder behoben werden muss. Sobald die Vorlage freigegeben ist, wird die Vorlage in der Vorlagengalerie mit dir als Urheber und deiner README als Beschreibung veröffentlicht. Von dort aus kann jeder sie als Ausgangspunkt für sein eigenes Design verwenden.

Wenn eine veröffentlichte Vorlage jemals korrigiert oder entfernt werden muss (deine eigene oder die einer anderen Person), siehe So meldest du Inhalte.

Nächste Schritte

• Vorlagengalerie – stöbere durch Community-Vorlagen
• So reichst du ein Pet ein – teile stattdessen einen animierten Sprite
• So meldest du Inhalte – melde ein Problem mit einem Pet oder einer Vorlage
• Nutzungsbedingungen – die Regeln, die für Einreichungen gelten