🪝Uso do LeftHook

Melhorar a qualidade dos códigos antes mesmo de subir para revisão.

Validações Locais com lefthook

Para evitar que código mal formatado ou com problemas simples de lint seja enviado ao repositório, utilizamos o lefthook, uma ferramenta leve e altamente configurável para gerenciar Git hooks.

💡 Por que usar hooks?

• Evita erros antes de subir código: os hooks impedem que commits inválidos cheguem ao controle de versão.

• Padroniza o fluxo entre devs: garante que todos estejam validando código da mesma forma, independente de IDE.

• Complementa o CI: reduz o tempo de feedback, já que falhas são identificadas antes mesmo da abertura de uma PR.

📦 Instalação

Recomendamos seguir a documentação oficial para instalar, pois existem diversos métodos (Homebrew, Python, binário direto etc).

Após instalar, rode no projeto:

lefthook install

📄 Exemplo de .lefthook.yml

pre-commit:
	parallel: false
	run_from_repo_root: true
	commands:
		fix:
			run: .fvm/flutter_sdk/bin/dart fix --apply
		format:
			run: .fvm/flutter_sdk/bin/dart format --set-exit-if-changed .
		analyze:
			run: .fvm/flutter_sdk/bin/flutter analyze

💬 Esse hook será executado automaticamente ao rodar git commit, garantindo que o código passe por uma etapa mínima de correções e validações.

📝 A utilização do .fvm/flutter_sdk pressupõe o uso de FVM para garantir versões específicas do Flutter por projeto. Altere os comandos conforme a necessidade.