Contribuer

Demander une icône

Ouvrez une demande d’icône qui indique à quoi sert l’icône, l’objet du quotidien qui la représente et son animation au survol. Les demandes dont l’objet est clair sont dessinées en premier.

Signaler un bogue d’icône

Pour signaler un problème, comme des raccords visibles, des tracés flous aux petites tailles ou une animation incorrecte, ouvrez un bogue d’icône et joignez une capture d’écran.

Proposer une icône

Si vous avez dessiné une icône avec le Skill ou à la main et ne souhaitez pas ouvrir de pull request, utilisez la page de soumission. Elle vérifie vos fichiers dans le navigateur et prépare une issue GitHub. Les fichiers restent dans le navigateur jusqu’à la publication de l’issue.

Exportez le dessin en SVG. Avec le Skill, lancez node scripts/export.mjs. Un SVG statique suffit : si l’icône est acceptée, l’animation est ajoutée lors de la relecture. Pour proposer votre propre animation, ajoutez le fichier source de l’icône.

Un mainteneur examine chaque proposition à l’œil, au regard des règles de design, à partir d’un aperçu publié dans l’issue. Les logos, les marques et tout ce qui est décalqué d’un autre jeu d’icônes ne peuvent pas être acceptés. Les icônes acceptées rejoignent la bibliothèque sous licence MIT, avec votre nom en crédit.

Pour qu’un agent de programmation envoie l’icône à votre place, collez ce prompt dans l’agent. Il vous demande de confirmer les conditions, puis publie l’issue avec la CLI GitHub :

Submit my icon to the Kubai Icons library:
1. Export it as an SVG by running node scripts/export.mjs --only <name> in the skill folder.
2. Ask me to confirm that I made it, that it contains no logos or copied artwork, and that I agree to publish it under the MIT License. Stop if I do not confirm.
3. Run gh issue create --repo kubai087/kubai-icons --title "[Icon submission] <name>" with a body using these headings: "### Name" (kebab-case), "### What it does on hover" and "### Files" (the SVG in a code block, plus the icon's .js source if there is one).
4. Tell me the issue link.

Dessiner une icône

Les icônes sont stockées dans icons/, à raison d’un module ES par icône. Dessinez-les avec le Skill Kubai Icons ou à la main, en suivant PROMPT.md et docs/authoring.md. Pour vérifier votre travail, remplacez my-icon ci-dessous par le nom de votre icône :

tools/check.mjs génère des planches-contacts, des images d’aperçu qui montrent votre icône à côté des icônes existantes listées avec --with. Joignez-les à votre pull request. La CI régénère les icônes modifiées et exécute les tests, puis un mainteneur évalue si l’icône s’intègre bien à l’ensemble.

Licence

Les icônes proposées et le code des paquets sont publiés sous licence MIT. Les modifications du site web et du Skill suivent leurs propres conditions, détaillées sur la page Licence.