Gerador SVG Stats Readme (GitHub)

README stats SVG do GitHub: badges dinâmicos, temas e self-hosting

Um README stats SVG é um badge dinâmico embutido no seu perfil GitHub que renderiza commits, stars, pull requests, issues e contribuições como um único SVG inline (~5KB). A ferramenta dominante no ecossistema é o github-readme-stats de Anuraghazra (67k+ stars, um dos 100 repos não-linguagem mais populares do GitHub). Os cards moram no repositório especial USERNAME/USERNAME — o GitHub trata o README dele como sua homepage de perfil, acima dos repos fixados. Use este gerador para pré-visualizar cards e produzir snapshots SVG estáticos compartilháveis que funcionam sem a API ao vivo.

Tipos de card e URLs de embed

O projeto github-readme-stats oferece vários tipos de card, cada um em um endpoint Vercel:

• Card de estatísticas: github-readme-stats.vercel.app/api?username=USER&theme=dark
• Top linguagens: /api/top-langs/?username=USER&layout=compact
• Streak counter: github-readme-streak-stats.herokuapp.com/?user=USER (projeto irmão, DenverCoder1)
• Integração WakaTime: tempo de codificação via conta WakaTime.

Embed com: ![Stats](https://github-readme-stats.vercel.app/api?username=USER)

Temas, personalização e suporte PT-BR

Mais de 90 temas embutidos vêm com o projeto: dark, radical, merko, gruvbox, tokyonight, onedark, cobalt, synthwave, transparent, dracula, prussian e mais. Totalmente customizável via query params: &bg_color=0d1117&title_color=58a6ff&text_color=c9d1d9&icon_color=39d353. Localização é suportada com &locale=pt-br — muito popular entre devs brasileiros.

Rate limits, cache e self-hosting

A instância pública na Vercel faz cache de respostas na CDN por aproximadamente 2 horas para mitigar rate limits da API do GitHub. Problema do efeito-manada: quando muitos usuários incorporam o mesmo card, a API upstream pode throttlear. A solução é self-hosting — forka o repo, faz deploy do seu próprio projeto Vercel com um token pessoal do GitHub e aponta o embed para sua URL custom, com capacidade ilimitada. Setup de cinco minutos; o README do projeto explica passo a passo.

Alternativas e cards complementares

Projetos irmãos úteis para combinar com o github-readme-stats:

• github-profile-trophy (Ryo-Maoka): troféus estilo achievement.
• github-readme-activity-graph (Ashutosh00710): gráfico de contribuições como SVG.
• novatorem (Jonny Burger): faixa do Spotify "ouvindo agora".
• Shields.io: badges customizados para stack, downloads, versão, licença.
• wakatime-readme: breakdown semanal de tempo de código por linguagem.

Perguntas frequentes

Tem rate limit? Sim — o endpoint público da Vercel compartilha cota da API do GitHub entre todos os usuários. Cards têm cache de CDN por ~2 horas. Para tráfego pesado, faça self-host.

Posso fazer self-host? Sim — forka anuraghazra/github-readme-stats, deploya no plano gratuito da Vercel, adiciona uma variável de ambiente PAT_1 com um personal access token do GitHub e você tem capacidade ilimitada.

Posso customizar cores além dos temas embutidos? Com certeza — toda cor é sobrescrevível via query string: bg_color, title_color, text_color, icon_color, border_color.

Funciona em repos privados? As stats refletem contribuições públicas por padrão. Para incluir contribuições privadas, passe &count_private=true em uma instância self-hosted cujo token tenha escopo de repo privado.