Skeletonic Stylus este un proiect open-source; contribuțiile de toate dimensiunile sunt binevenite — de la corectarea unei greșeli de tipar până la componente noi.
Start rapid
# 1. Fork & clonare
git clone git@github.com:YOUR-USER/skeletonic-stylus.git
cd skeletonic-stylus
# 2. Instalare (pnpm via corepack)
corepack enable
pnpm install
# 3. Build
pnpm run build # pipeline complet (stylus → prettier → stylelint → autoprefixer → csso)
# 4. Lint & testare
pnpm run lint
node scripts/a11y-test.mjs
Convenții
- Nume de branch-uri:
feat/scurt-descriere,fix/scurt-descriere,docs/scurt-descriere. - Commit-uri: Conventional Commits. Toate commit-urile sunt semnate.
- Stylus: indentare cu 4 spații, fără punct și virgulă, preferă
$variablesîn loc de numere magice, fiecare clasă publică este într-un cascade layer. - Accesibilitate: orice componentă nouă trebuie să demonstreze conformitate WCAG 2.2 AA; rulează
node scripts/a11y-test.mjspe pagina showcase înainte de a deschide un PR. - Buget de dimensiune: stylesheet-ul principal trebuie să rămână sub 8 KB gzipped. Dacă modificarea ta depășește limita, justifică în PR.
Pull request-uri
- Deschide mai întâi un issue pentru orice lucru non-trivial — economisește timp și efort.
- Menține PR-urile focalizate: o singură modificare logică per PR.
- Actualizează
CHANGELOG.mdla secțiunea „Unreleased". - Asigură-te că CI este verde înainte de a solicita review.
- Squash-merge este metoda implicită; mesajele de commit vor fi curățate la merge.
Cod de conduită
Prin participare, accepți să respecți Contributor Covenant 2.1. Fii amabil, fii răbdător, presupune intenție bună.