Gerador de Badge Shields.io

Você quer colocar no README aquele selo cinza e verde do tipo build passing, mas a URL do shields.io tem uma gramática própria: rótulo, mensagem e cor separados por hífen, no meio do caminho. Só que o seu texto também tem hífen, e o resultado sai partido no lugar errado. Este montador escreve a URL certa e já entrega a linha em Markdown pronta para colar.

A regra que resolve quase todo problema é a de escape do próprio shields.io: dentro do caminho, o hífen separa os três pedaços e o sublinhado vira espaço. Para mostrar um hífen literal você escreve dois, e para um sublinhado literal, dois também. A ferramenta faz essa duplicação antes de codificar a URL, então digite o texto normal e deixe a conversão com ela. O que sai é sempre um badge estático, no estilo padrão.

Este é o endpoint de badge fixo: ele não consulta o seu CI, não lê a versão do package.json e não aceita parâmetros de estilo ou logo. Se você quer um selo que muda sozinho conforme o build, precisa dos endpoints dinâmicos do shields, que são outras URLs. Nas cores, use nomes como brightgreen, blue, orange e lightgrey, ou um hexadecimal sem cerquilha. A URL é montada no navegador, e a página não mostra prévia da imagem.