Skeletonic Stylus e um projeto de codigo aberto; contribuicoes de todos os tamanhos sao bem-vindas — de correcoes de digitacao a novos componentes.
Inicio rapido
# 1. Fork & clone
git clone git@github.com:SEU-USUARIO/skeletonic-stylus.git
cd skeletonic-stylus
# 2. Instalar (pnpm via corepack)
corepack enable
pnpm install
# 3. Build
pnpm run build # pipeline completo (stylus → prettier → stylelint → autoprefixer → csso)
# 4. Lint & teste
pnpm run lint
node scripts/a11y-test.mjs
Convencoes
- Nomes de branch:
feat/descricao-curta,fix/descricao-curta,docs/descricao-curta. - Commits: Conventional Commits. Todos os commits sao assinados.
- Stylus: indentacao de 4 espacos, sem ponto-e-virgula, preferir
$variablesa numeros magicos, toda classe publica vive em uma cascade layer. - Acessibilidade: qualquer novo componente deve comprovadamente
atender WCAG 2.2 AA; execute
node scripts/a11y-test.mjscontra a pagina de demonstracao antes de abrir um PR. - Budget de tamanho: a folha de estilos principal deve permanecer abaixo de 8 KB gzipped. Se sua alteracao ultrapassar esse limite, justifique no PR.
Pull requests
- Abra uma issue primeiro para qualquer coisa nao trivial — economiza retrabalho.
- Mantenha os PRs focados: uma mudanca logica por PR.
- Atualize o
CHANGELOG.mdna secao "Unreleased". - Certifique-se de que o CI esteja verde antes de solicitar revisao.
- Squash-merge e o padrao; as mensagens de commit serao limpas no merge.
Codigo de conduta
Ao participar, voce concorda em seguir o Contributor Covenant 2.1. Seja gentil, seja paciente, presuma boa intencao.