Básico
Conventional Commits
Padrão de mensagens de commit com prefixos semânticos como feat:, fix: e docs: para facilitar a leitura do histórico.
Padronizando mensagens de commit
Sem padrão, o histórico de um repositório vira mensagens vagas como "ajustes", "arrumei" ou "final agora vai". O Conventional Commits resolve isso usando a estrutura:
tipo(escopo opcional): descrição curta no imperativo
Principais tipos usados em projetos
| Tipo | Quando usar | Exemplo |
|---|---|---|
feat |
Nova funcionalidade para o usuário | feat(quiz): adiciona filtro por trilha |
fix |
Correção de bug | fix(paginacao): traduz botoes em pt_BR |
docs |
Apenas documentação ou notas | docs: atualiza guia de instalacao |
style |
Formatação, espaços, lint (sem mudar lógica) | style: aplica padrao Laravel Pint |
refactor |
Reestruturação interna sem mudar comportamento | refactor: extrai servico de importacao |
test |
Adição ou ajuste de testes | test: cobre paginacao da home |
chore |
Tarefas de build, dependências ou config | chore: atualiza Dockerfile de producao |
Exemplo Prático
bash
# Exemplos bons seguindo Conventional Commits:
git commit -m "feat(auth): adiciona bloqueio para usuario inativo"
git commit -m "fix(api): trata erro 401 ao renovar token"
git commit -m "docs(readme): inclui passos de setup com Sail"
git commit -m "test(quiz): valida pontuacao ao finalizar tentativa"