Skeletonic Stylus — проект с открытым исходным кодом; приветствуются вклады любого масштаба — от исправления опечаток до новых компонентов.
Быстрый старт
# 1. Форк и клонирование
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. Будьте вежливы, будьте терпеливы, предполагайте добрые намерения.