github-visitor-counter

GitHub Visitor Counter é uma ferramenta open-source que exibe bandeiras de países dos visitantes no README do seu perfil GitHub. Funciona como uma API serverless implantada no Vercel, exigindo zero manutenção ou cadastro de conta. ## Visão Geral Usuários adicionam uma única tag de imagem markdown ao README do perfil GitHub para mostrar a origem dos visitantes. O serviço integra-se à Flag Counter API e oferece quatro modos de exibição: Países Principais, Mapa de Bandeiras, Bandeiras De (EUA/CAN) e Contador Mini. ## Principais Recursos - **Integração de uma linha**: Adicione uma única linha markdown a qualquer README de perfil GitHub - **Sem cadastro necessário**: Funciona imediatamente com apenas um nome de usuário GitHub - **Quatro modos de exibição**: Lista de países principais, visualização de mapa geográfico, bandeiras filtradas por localização e contador compacto - **Múltiplos temas**: Padrão, Dark, GitHub, GitHub Dark e Transparent - **Contadores por repositório**: Acompanhe visitas a repositórios individuais separadamente - **Compatível com ID oficial**: Suporta IDs existentes do Flag Counter para integração com painel - **Ferramenta de configuração em tempo real**: Painel web interativo com visualização instantânea - **Atalhos de teclado e importação/exportação de configuração** para usuários avançados ## Modos de Exibição 1. **Países Principais**: Grade de bandeiras ordenadas por contagem de visitantes 2. **Mapa de Bandeiras**: Visualização geográfica de localizações dos visitantes 3. **Bandeiras De**: Bandeiras filtradas mostrando apenas visitantes de países especificados (EUA ou Canadá) 4. **Contador Mini**: Exibição compacta mostrando contagem de bandeiras ou visualizações de página ## Stack Tecnológica Desenvolvido com Next.js 15, React 19, TypeScript, Tailwind CSS e implantado no Vercel com cache CDN global. ## Uso Adicione ao README do seu perfil GitHub:  Parâmetros opcionais incluem `displayMode`, `theme`, `columns`, `maxflags`, `label`, cores personalizadas e mais. A contagem por repositório usa `repo` ou o formato combinado `nomeusuario/repositorio`. Usuários existentes do Flag Counter podem passar o parâmetro `counterId`. ## Autohospedagem O projeto tem licença MIT e pode ser autohospedado via implantação no Vercel ou desenvolvimento local com `npm run dev`. Todo o código-fonte está disponível no repositório.