Comment proposer un modèle

Avant de commencer

Vous aurez besoin de deux choses avant de soumettre.

1. Un compte GitHub. Votre dépôt de modèle doit être hébergé sur GitHub. Si vous n'avez pas de compte, créez-en un d'abord.
2. Un projet finalisé. Vérifiez votre interface, puis exportez son fichier .picopixel depuis PicoPixel pour l’ajouter au dépôt.

Configurer votre dépôt GitHub

Créez un nouveau dépôt GitHub public pour votre soumission de modèle. Le dépôt doit contenir trois choses :

1. Votre fichier .picopixel

Placez votre fichier de projet .picopixel à la racine du dépôt. C'est le fichier que les gens téléchargeront et ouvriront dans PicoPixel, alors assurez-vous que c'est la version finale.

2. Images de présentation

Ajoutez les images que vous souhaitez afficher à côté de votre modèle dans la galerie. Elles aident les gens à voir à quoi ressemble le design avant de le télécharger.

• Placez les images à la racine du dépôt ou dans un dossier comme images/.
• Utilisez des formats courants : .png, .jpg ou .webp.
• Incluez au moins une capture d'écran de votre design en action. Plusieurs angles ou écrans, c'est encore mieux.
• Gardez les images à une taille raisonnable — assez grandes pour voir les détails, mais pas inutilement énormes.

3. Un README

Rédigez un README.md à la racine du dépôt. Il est utilisé comme description du modèle dans la galerie, alors traitez-le comme la page publique de votre modèle.

Un bon README doit couvrir :

• Ce qu'est le modèle — un bref résumé du design et à quoi il sert.
• Résolution cible et matériel — la carte ou l'écran pour lequel il a été conçu, pour que les gens sachent s'il convient à leur installation.
• Ce qui est inclus — listez les écrans, widgets et fonctionnalités clés. Par exemple : "deux écrans : un tableau de bord principal et une page de paramètres, avec des curseurs, des interrupteurs et un widget d'horloge."
• Crédits — si vous avez utilisé des ressources tierces que vous êtes autorisé à partager, nommez-les et leur source.

Voici un exemple minimal :

# 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).

Remplir le formulaire

Une fois votre dépôt prêt, accédez au formulaire de soumission.

1. Ouvrez l'application PicoPixel et connectez-vous.
2. Cliquez sur votre compte en bas de la barre latérale gauche, puis choisissez Your account.
3. Dans la barre latérale Your account, ouvrez Submit a Template.

Le formulaire comporte trois champs :

• GitHub Repository Link — l'URL de votre dépôt GitHub public (p. ex. https://github.com/votrenom/mon-modele). Le dépôt doit être public pour que l'équipe de vérification puisse y accéder. Vérifiez que le dépôt contient votre fichier .picopixel, les images et le README avant de soumettre.
• Author / Credits — le nom que vous voulez afficher comme créateur du modèle. Ajoutez toute personne qui doit être créditée à vos côtés.
• Notes (optionnel) — tout ce que l'équipe de vérification devrait savoir et qui ne figure pas dans votre README. Par exemple, si certaines images ne doivent pas être utilisées dans la galerie, ou s'il y a un contexte sur le design qui n'appartient pas à la description publique.

Vérifiez les informations, puis envoyez le formulaire.

Droits et autorisations

En proposant un modèle, vous accordez des droits de publication et d’utilisation. Lisez les conditions suivantes avant de l’envoyer.

En soumettant, vous accordez à PicoPixel la permission d'accéder, de télécharger et de publier publiquement le contenu de votre dépôt dans la galerie de modèles communautaires. Les modèles publiés sont mis à disposition sans restrictions de droits d'auteur ni exigences de licence, afin que n'importe qui puisse les utiliser librement dans ses propres projets, y compris à des fins commerciales. Votre nom est affiché, mais le modèle lui-même est libre d'utilisation pour les autres.

Cela signifie que vous ne devez soumettre que du travail que vous êtes à l'aise de partager dans ces conditions. Si une partie de votre design utilise une ressource que vous n'avez pas créée — une police, un ensemble d'icônes, une image ou autre chose — et que vous n'êtes pas certain de pouvoir la partager librement et sans restriction, retirez-la avant de soumettre. Dans le doute, abstenez-vous : un modèle propre est bien plus utile aux autres qu'un modèle qui devra être retiré plus tard.

PicoPixel peut supprimer du contenu qui porte atteinte aux droits de tiers. Consultez les Conditions d'utilisation.

Ce qui se passe ensuite

L’équipe PicoPixel clone votre dépôt et vérifie que le fichier .picopixel s’ouvre correctement, que les images et le README conviennent à la galerie et que le contenu respecte les Conditions d’utilisation.

L’équipe peut vous demander des précisions ou des corrections. Une fois validé, le modèle apparaît dans la galerie de modèles, avec votre nom et le contenu du README comme description. Chacun peut alors l’ouvrir et l’adapter à son projet.

Si un modèle publié doit un jour être corrigé ou retiré (le vôtre ou celui de quelqu'un d'autre), consultez Comment signaler du contenu.

Où aller ensuite

• Galerie de modèles : parcourez les modèles communautaires
• Comment soumettre une mascotte : partagez un sprite animé à la place
• Comment signaler du contenu : signalez un problème avec une mascotte ou un modèle
• Conditions d'utilisation : les règles qui s'appliquent aux soumissions