O que ProofShot — Fluxo de Verificação Visual faz?
ProofShot é um CLI de código aberto e agnóstico a agentes que permite verificar seu próprio trabalho em um navegador real — vídeo prova, capturas de tela e relatórios de erro, sem dependência de fornecedor.
Quando usar
Use ProofShot após:
- Construir um novo recurso ou página de UI
- Modificar componentes de UI existentes
- Corrigir um bug visual
- Qualquer alteração que afete o que o usuário vê
O fluxo de trabalho (sempre siga estes 3 passos)
Passo 1: Inicie a sessão
proofshot start --run "seu-comando-de-dev" --port PORTA --description "o que você está prestes a verificar"
Isso abre um navegador e começa a gravação. Se a porta já estiver em uso, o proofshot irá matar o processo existente automaticamente.
Sempre use --run para que o proofshot inicie e capture a saída do seu servidor de desenvolvimento (os logs do servidor aparecem no relatório de prova).
Omite --run apenas se o servidor foi explicitamente iniciado pelo usuário ou por outro processo — sem ele, nenhum log do servidor é capturado.
Se uma sessão anterior não foi encerrada corretamente, adicione --force para sobrescrevê-la.
Passo 2: Dirija o navegador e teste
Use proofshot exec para navegar, interagir e verificar:
proofshot exec snapshot -i # Veja elementos interativos
proofshot exec open http://localhost:PORTA/pagina # Navegue para uma página
proofshot exec click @e3 # Clique em um botão
proofshot exec fill @e2 "[email protected]" # Preencha um campo de formulário
proofshot exec screenshot passo-NOME.png # Capture momentos chave
Tire capturas de tela em momentos importantes — elas se tornam a prova visual. Verifique o que você espera ver lendo a saída do snapshot.
Passo 3: Pare e empacote a prova
proofshot stop
Isso para a gravação, coleta erros do console e do servidor, e gera um SUMMARY.md com vídeo, capturas de tela e relatório de erros.
Passo 4 (opcional): Poste a prova no PR
proofshot pr # Detecta automaticamente o PR da branch atual
proofshot pr 42 # Alveja um número de PR específico
Isso faz upload das capturas de tela e vídeo para o GitHub e publica um comentário formatado no PR. Por padrão, usa a API oficial de conteúdo do GitHub em uma branch chamada proofshot-artifacts. Use --upload-provider github-web-attachments se você quiser especificamente URLs de anexos do GitHub.
Dicas
- Sempre inclua uma
--descriptionsignificativa para que o humano saiba o que foi testado - Tire capturas de tela ANTES e DEPOIS de ações chave (por exemplo, antes de enviar formulário, após redirecionamento)
- Se encontrar erros durante a verificação, corrija-os e reexecute o fluxo de trabalho
- Use
proofshot prapós parar para anexar a prova diretamente ao pull request