Skeletonic Stylus — це проєкт з відкритим кодом; внески будь-якого масштабу вітаються — від виправлення друкарських помилок до нових компонентів.
Швидкий старт
# 1. Fork та clone
git clone git@github.com:YOUR-USER/skeletonic-stylus.git
cd skeletonic-stylus
# 2. Встановлення (pnpm через corepack)
corepack enable
pnpm install
# 3. Збірка
pnpm run build # повний пайплайн (stylus → prettier → stylelint → autoprefixer → csso)
# 4. Лінтинг та тестування
pnpm run lint
node scripts/a11y-test.mjs
Конвенції
- Назви гілок:
feat/short-thing,fix/short-thing,docs/short-thing. - Коміти: Conventional Commits. Усі коміти підписані.
- Stylus: 4-пробільний відступ, без крапок з комою, перевага
$variablesзамість магічних чисел, кожен публічний клас знаходиться в каскадному шарі. - Доступність: будь-який новий компонент повинен демонстративно
відповідати WCAG 2.2 AA; запустіть
node scripts/a11y-test.mjsна сторінці-вітрині перед створенням PR. - Бюджет розміру: основна таблиця стилів повинна залишатися менше 8 КБ gzip. Якщо ваша зміна перевищує ліміт, обґрунтуйте це в PR.
Pull request-и
- Спочатку створіть issue для будь-чого нетривіального — заощадить зайву роботу.
- Зберігайте PR фокусованими: одна логічна зміна на PR.
- Оновіть
CHANGELOG.mdу розділі «Unreleased». - Переконайтесь, що CI зелений, перш ніж запитувати рев'ю.
- Squash-merge — стандартний підхід; повідомлення комітів будуть упорядковані при злитті.
Кодекс поведінки
Беручи участь, ви погоджуєтесь дотримуватись Contributor Covenant 2.1. Будьте ввічливі, терплячі та виходьте з добрих намірів.