Skeletonic Stylus est un projet open source ; toutes les contributions sont les bienvenues — des corrections de coquilles aux nouveaux composants.
Démarrage rapide
# 1. Fork et clone
git clone git@github.com:VOTRE-UTILISATEUR/skeletonic-stylus.git
cd skeletonic-stylus
# 2. Installation (pnpm via corepack)
corepack enable
pnpm install
# 3. Build
pnpm run build # pipeline complète (stylus → prettier → stylelint → autoprefixer → csso)
# 4. Lint et tests
pnpm run lint
node scripts/a11y-test.mjs
Conventions
- Noms de branches :
feat/description-courte,fix/description-courte,docs/description-courte. - Commits : Conventional Commits. Tous les commits sont signés.
- Stylus : indentation de 4 espaces, pas de point-virgule, préférer
les
$variablesaux valeurs en dur, chaque classe publique vit dans une couche de cascade. - Accessibilité : tout nouveau composant doit satisfaire WCAG 2.2 AA
de manière démontrable ; exécuter
node scripts/a11y-test.mjssur la vitrine avant d'ouvrir une PR. - Budget de taille : la feuille de style principale doit rester sous 8 Ko gzippé. Si votre modification dépasse ce seuil, justifiez-la dans la PR.
Pull requests
- Ouvrir d'abord un ticket pour toute modification non triviale — cela évite le travail inutile.
- Garder les PR ciblées : une modification logique par PR.
- Mettre à jour le
CHANGELOG.mddans la section « Unreleased ». - Vérifier que la CI est au vert avant de demander une revue.
- Le squash-merge est la norme ; les messages de commit seront nettoyés lors de la fusion.
Code de conduite
En participant, vous vous engagez à respecter le Contributor Covenant 2.1. Soyez bienveillant, patient et partez du principe que les intentions sont bonnes.