Resposta rápida: GitHub Streak Stats é um widget de README, não uma nota de produtividade
GitHub streak stats normalmente é um cartão de README que calcula dias consecutivos ou atividade em sequência a partir das contribuições públicas. Ele é um sinal visual rápido, mas não um registro completo do trabalho.
O uso ideal é específico: adicione o cartão quando quiser um indicador leve no README do perfil. Para estruturar o perfil, use o guia de template de GitHub profile README; para imagem 3D automática, veja profile-3d-contrib; para exploração 3D, use GitHub City.
Antes de alterar o widget, compare com o gráfico oficial. Se o GitHub não conta um commit por e-mail, branch, fork, visibilidade privada ou atraso, o cartão geralmente também não recupera esse dado.
Como adicionar GitHub Streak Stats sem poluir o README
Uma boa configuração é pequena e intencional. Coloque o cartão perto da seção de atividade ou prova, mantenha a explicação curta e evite empilhar muitos widgets remotos antes dos projetos.
O cartão deve responder a uma pergunta: este perfil mostra atividade visível? Ele não deve ser o destaque principal se o README ainda não explica quem você é, o que constrói e quais projetos importam.
Define qué prueba la tarjeta
Úsala para mostrar ritmo visible de contribución, no como única prueba de habilidad, seniority o fiabilidad.
Copia la URL oficial
Empieza desde el servicio o repositorio mantenido, configura el username y elige un tema legible en modo claro y oscuro.
Insértala en README.md
Usa Markdown normal o una etiqueta HTML con alt útil. Colócala bajo el resumen y cerca de la prueba de proyectos.
Revisa el gráfico oficial
Si la racha parece rota, consulta las reglas de contribución antes de tocar la tarjeta. La guía del contribution graph cubre las causas comunes.
Añade contexto, no más widgets
Una tarjeta de racha más una tarjeta de stats o un enlace a GitHub City suele bastar. Demasiadas tarjetas ralentizan y distraen.
GitHub Streak Stats vs GitHub Readme Stats vs GitHub City
Um cartão de sequência deve apoiar projetos reais, não competir com eles. Coloque-o depois do resumo, use alt claro e explique que ele mede atividade visível do GitHub, não todo o trabalho de engenharia. Se o perfil precisa de estrutura, comece pelo guia de README template; para uma visão 3D, use GitHub City.
These tools sit at different layers of the profile story. Streak stats focus on consistency, GitHub Readme Stats summarizes repository or language signals, and GitHub City turns contribution history into an interactive 3D scene.
| Opção | Melhor para | Configuração | Risco | Melhor uso |
|---|---|---|---|---|
| GitHub streak stats | Mostrar ritmo visible en un README de perfil. | Añadir una URL remota o referencia de imagen. | Puede parecer una nota de productividad si no se explica. | Señal compacta cerca de la prueba de proyectos. |
| GitHub Readme Stats | Mostrar lenguaje, repositorios o resumen general. | Configurar parámetros y temas. | Muchas tarjetas pueden volver lento y confuso el README. | Úsalo cuando la tarjeta apoye los proyectos. |
| GitHub City | Explorar contribuciones como ciudad 3D. | Abrir la herramienta y escribir un username. | No es una tarjeta de README si no se enlaza con claridad. | Cuando quieres un visual interactivo memorable. |
| profile-3d-contrib | Generar imágenes 3D para README con Actions. | Configurar permisos y rutas de salida. | Un fallo de workflow puede romper la imagen. | Cuando el README necesita archivos 3D generados. |
Resolver cartões de sequência quebrados, vazios ou enganosos
Most streak problems are data problems, not design problems. If the official contribution graph is missing activity, the card will usually miss it too. Start with commit email, default branch, fork behavior, repository visibility, private contribution settings, and update delays.
The next layer is card configuration. Check the username, URL encoding, theme name, cache behavior, and whether GitHub can fetch the remote image. If the README is slow or visually heavy, remove extra widgets before adding another one.
La racha se reinició
Comprueba si el día faltante aparece en el gráfico oficial. Si no, revisa email, ramas, forks, ajustes privados y zona horaria.
La tarjeta está en blanco
Confirma que el servicio responde, que el username es correcto y que GitHub puede cargar la imagen remota.
El README está saturado
Mantén una tarjeta de actividad, proyectos claros y un enlace visual opcional. Baja lo decorativo.
La métrica parece injusta
Aclara que refleja actividad visible de GitHub, no todo el trabajo de ingeniería ni la calidad del código.
Onde colocar um cartão de sequência em um perfil forte
Um cartão de sequência funciona melhor depois do resumo inicial e antes ou depois dos projetos principais. Assim ele dá um sinal rápido sem esconder a prova do portfólio.
Para contar uma história de portfólio, combine contexto escrito, projetos reais e uma camada visual: cartão de sequência, GitHub Readme Stats, profile-3d-contrib ou link para GitHub City. Não deixe tudo competir no topo.
Se o perfil já usa GitHub City, apresente como exploração: o visitante pode abrir a cidade 3D para entender o padrão por trás do cartão.
Regra prática
Se o cartão não torna o próximo projeto mais confiável, mova-o para baixo ou remova-o.
FAQ
O que é GitHub streak stats?
É um visual de README que mostra atividade consecutiva ou em sequência com base nas contribuições públicas.
Como adiciono ao meu perfil?
Adicione uma URL de cartão mantida ao README.md do repositório especial com seu username e confira o carregamento.
Por que minha sequência reiniciou?
Geralmente porque o GitHub não contou atividade visível em um ou mais dias, ou por cache/configuração do serviço.
É igual ao GitHub Readme Stats?
Não. Streak stats foca atividade consecutiva; GitHub Readme Stats resume perfil, repositórios ou linguagens.
Devo usar com GitHub City?
Sim, quando cada um tem função clara: cartão rápido no README e GitHub City para exploração interativa.