github-stats-dashboard
Dashboard estadístico GitHub auto-hospedado estático + tarjetas SVG embebibles. Sin backend, sin límites de tasa externos y cero dependencias de tiempo de ejecución.
Ficha actualizada 22 sept 2026, 18:19 · upstream 22 sept 2026, 16:41 · release sin release detectada
Qué es github-stats-dashboard
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio implementa una solución completa para visualizar estadísticas de GitHub mediante un dashboard estático y tarjetas SVG embebibles. La arquitectura se basa en la generación programática de datos: un GitHub Action programado consulta la API GraphQL, procesa las métricas y genera archivos JSON y SVGs que alimentan tanto el dashboard como las tarjetas individuales.
La clave del diseño es la separación entre la lógica de recolección de datos (CI/CD) y el consumo (frontend estático). Esto garantiza que no haya dependencias de servidor, bases de datos ni tokens expuestos al lado del cliente. El dashboard se sirve a través de GitHub Pages desde la carpeta `docs`, mientras que las tarjetas SVG están optimizadas para ser incrustadas directamente en READMEs de perfiles.
La configuración permite personalización granular: exclusión de lenguajes específicos (útil para evitar sesgos por archivos de notebook), definición de temas de color y control sobre qué métricas se incluyen. El sistema soporta tanto datos públicos como privados, siempre que se configuren los secretos adecuados en el entorno de GitHub Actions.
- Crear un dashboard público de estadísticas personales alojado en GitHub Pages sin backend
- Generar tarjetas SVG embebibles para READMEs de perfiles que muestren contribuciones y lenguajes
- Automatizar la actualización de métricas cada 12 horas mediante GitHub Actions
- Implementar un sistema de estadísticas con privacidad mejorada (tokens solo en CI/CD)
- Personalizar colores y temas de las tarjetas SVG para coincidir con el branding personal
- Arquitectura sin servidor: El dashboard es estático, eliminando la necesidad de mantener servidores o bases de datos
- Privacidad de tokens: Los credenciales se manejan exclusivamente en GitHub Actions, nunca expuestos al navegador del usuario final
- Actualización automática: El workflow regenera los datos cada 12 horas y permite disparos manuales para actualizaciones inmediatas
- Reutilización de activos: Un mismo conjunto de datos alimenta tanto el dashboard completo como las tarjetas embebibles
- Personalización nativa: Soporte para excluir lenguajes específicos y definir temas de color en los SVGs
- Dependencia de GitHub Pages: Requiere activar GitHub Pages para servir los activos SVG correctamente (no funciona con raw.githubusercontent.com)
- Límites de API GraphQL: Las consultas pueden fallar si se acercan a los límites de tasa de la API de GitHub, aunque el uso es bajo
- Configuración manual de secretos: Para incluir contribuciones privadas, es obligatorio configurar un token personal en las variables de entorno del repositorio
- Sin soporte para autenticación OAuth: Solo soporta tokens de acceso o tokens integrados de GitHub Actions
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Activar GitHub Pages en la rama main apuntando a la carpeta /docs. Asegurar que el workflow .github/workflows/update-stats.yml tenga permisos para escribir commits. Para métricas privadas, configurar el secreto STATS_TOKEN con un token de acceso personal (scopes: repo, read:user). El despliegue es inmediato tras cada commit del workflow o ejecución manual.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.