Skeletonic Stylus e un progetto open source; contributi di qualsiasi dimensione sono benvenuti — dalla correzione di errori di battitura ai nuovi componenti.
Avvio rapido
# 1. Fork & clone
git clone git@github.com:YOUR-USER/skeletonic-stylus.git
cd skeletonic-stylus
# 2. Installa (pnpm via corepack)
corepack enable
pnpm install
# 3. Build
pnpm run build # pipeline completa (stylus → prettier → stylelint → autoprefixer → csso)
# 4. Lint & test
pnpm run lint
node scripts/a11y-test.mjs
Convenzioni
- Nomi dei branch:
feat/breve-descrizione,fix/breve-descrizione,docs/breve-descrizione. - Commit: Conventional Commits. Tutti i commit sono firmati.
- Stylus: indentazione a 4 spazi, niente punti e virgola, preferire
$variablesai numeri magici, ogni classe pubblica risiede in un cascade layer. - Accessibilita: ogni nuovo componente deve dimostrabilmente soddisfare WCAG 2.2 AA; esegui
node scripts/a11y-test.mjssulla pagina showcase prima di aprire una PR. - Budget di dimensione: il foglio di stile principale deve restare sotto gli 8 KB gzipped. Se la tua modifica lo supera, giustificalo nella PR.
Pull request
- Apri prima una issue per qualsiasi modifica non banale — evita lavoro inutile.
- Mantieni le PR focalizzate: una modifica logica per PR.
- Aggiorna il
CHANGELOG.mdsotto "Unreleased". - Assicurati che la CI sia verde prima di richiedere la review.
- Lo squash-merge e il default; i messaggi di commit verranno ripuliti al merge.
Codice di condotta
Partecipando, accetti di rispettare il Contributor Covenant 2.1. Sii gentile, sii paziente, presumi buone intenzioni.