Come contribuire

Richiedere un'icona

Apri una richiesta di icona che indichi a cosa serve l'icona, l'oggetto di uso quotidiano che la rappresenta e la sua animazione hover. Le richieste con un oggetto chiaro vengono disegnate per prime.

Segnalare un bug di un'icona

Per segnalare un problema, come giunture visibili, segni sfocati a dimensioni ridotte o animazione errata, apri un bug dell'icona e allega uno screenshot.

Inviare un'icona

Se hai disegnato un'icona con la Skill o a mano e non vuoi aprire una pull request, usa la pagina di invio. Controlla i file nel browser e prepara una issue su GitHub. I file restano nel browser finché non pubblichi la issue.

Esporta il disegno come SVG. Con la Skill, esegui node scripts/export.mjs. Basta un SVG statico: se l'icona viene accettata, l'animazione viene aggiunta durante la revisione. Per proporre una tua animazione, aggiungi il file sorgente dell'icona.

Un maintainer esamina ogni invio a occhio rispetto alle regole di design, usando un'anteprima pubblicata nella issue. Loghi, marchi e qualsiasi cosa ricalcata da un altro set di icone non possono essere accettati. Le icone accettate entrano nella libreria con licenza MIT, con il tuo nome come autore.

Per far inviare l'icona a un agente di programmazione, incolla in esso questo prompt. L'Agent ti chiede di confermare le condizioni, poi pubblica la issue con la CLI di 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.

Disegnare un'icona

Le icone sono in icons/, un modulo ES per icona. Disegnale con la Kubai Icons Skill o a mano, seguendo PROMPT.md e docs/authoring.md. Per controllare il lavoro, sostituisci my-icon qui sotto con il nome della tua icona:

tools/check.mjs genera i contact sheet, cioè immagini di anteprima che mostrano la tua icona accanto alle icone esistenti indicate con --with. Allegali alla tua pull request. La CI renderizza di nuovo le icone modificate ed esegue i test, e un maintainer valuta quanto l'icona si adatta al set.

Licenza

Le icone contribuite e il codice dei pacchetti sono rilasciati con licenza MIT. Le modifiche al sito web e alla Skill seguono condizioni proprie, elencate nella pagina Licenza.