github-visitor-counter

GitHub Visitor Counter es una herramienta de código abierto que muestra las banderas de los países de los visitantes en el README de tu perfil de GitHub. Funciona como una API sin servidor desplegada en Vercel, sin necesidad de mantenimiento ni registro de cuenta. ## Visión general Los usuarios añaden una única etiqueta de imagen en markdown a su README de perfil de GitHub para mostrar de dónde provienen los visitantes. El servicio se integra con la Flag Counter API y ofrece cuatro modos de visualización: Países principales, Mapa de banderas, Banderas desde (EE.UU./CA) y Contador mini. ## Características principales - **Integración de una línea**: Añade una única línea de markdown a cualquier README de perfil de GitHub - **Sin registro requerido**: Funciona inmediatamente con solo un nombre de usuario de GitHub - **Cuatro modos de visualización**: Lista de países principales, visualización en mapa geográfico, banderas filtradas por ubicación y contador compacto - **Múltiples temas**: Predeterminado, Oscuro, GitHub, GitHub Oscuro y Transparente - **Conteo por repositorio**: Realiza seguimiento de visitas a repositorios individuales por separado - **Compatible con ID oficial**: Soporta IDs existentes de Flag Counter para integración con panel de control - **Herramienta de configuración en tiempo real**: Panel web interactivo con vista previa en vivo - **Atajos de teclado e importación/exportación de configuración** para usuarios avanzados ## Modos de visualización 1. **Países principales**: Cuadrícula de banderas ordenadas por cantidad de visitantes 2. **Mapa de banderas**: Visualización geográfica de ubicaciones de visitantes 3. **Banderas desde**: Banderas filtradas mostrando solo visitantes de países especificados (EE.UU. o Canadá) 4. **Contador mini**: Visualización compacta que muestra cantidad de banderas o vistas de página ## Tecnologías utilizadas Desarrollado con Next.js 15, React 19, TypeScript, Tailwind CSS, y desplegado en Vercel con caché CDN global. ## Uso Añade al README de tu perfil de GitHub: ```  ``` Parámetros opcionales incluyen `displayMode`, `theme`, `columns`, `maxflags`, `label`, colores personalizados y más. El conteo por repositorio utiliza `repo` o el formato combinado `username/repo`. Usuarios existentes de Flag Counter pueden pasar el parámetro `counterId`. ## Autohospedaje El proyecto tiene licencia MIT y puede autohospedarse mediante despliegue en Vercel o desarrollo local con `npm run dev`. Todo el código fuente está disponible en el repositorio.