Contribuindo

A fonte completa de verdade vive em CONTRIBUTING.md. Destaques:

Workflow

git checkout main && git pull origin main && git checkout -b feat/short-summary
# work
pnpm format && pnpm lint && pnpm typecheck && pnpm build
pnpm changeset      # if your change is user-visible
git commit -m "feat(ui): add Button loading state"
git push -u origin feat/short-summary
gh pr create

Atômico antes de composto

Nenhuma UI nova é construída em um app antes de seus átomos existirem aqui. Se o átomo estiver faltando, adicione-o aqui primeiro e então use-o.

Esta é a regra mais difícil de fazer cumprir, e a mais valiosa. Todo PR de app que introduz “só um botão custom rápido” atrasa o sistema. Gaste a hora extra entregando-o aqui primeiro.

Fidelidade à marca

Puxe tokens de @velon-finance/tokens. Nunca cravar hexes na mão.
Use utilitários semânticos (bg-card, text-foreground) por padrão. Recorra ao literal (bg-primary / bg-velon-navy) apenas quando a marca deve ficar fixa em relação ao tema (o wordmark, superfícies de marketing).
O wordmark Velon é sempre escrito em caixa alta: VELON (combinado com FINANCE no lockup). Nunca o reestilize.
Border radius padrão: 8px para botões/inputs, 12px para cards/modais.

Acessibilidade

Contraste WCAG AA em cada combinação de texto/fundo. Verifique ao introduzir uma nova combinação.
A navegação por teclado funciona sem mouse. A ordem de tabulação faz sentido.
Leitor de tela: cada átomo acionável tem um label.
Respeite prefers-reduced-motion. (VelonLogoIntro é o exemplo canônico.)

Changesets

Toda mudança visível ao usuário é entregue com pnpm changeset descrevendo o que mudou e por quê. Mudanças apenas internas (chore / docs / ci / test / refactor) pulam o gate automaticamente.

Veja CONTRIBUTING.md para o conjunto completo de regras.

Instalação Changelog