gh-stats
Servidor Vercel en Node.js con Next.js que genera SVG cards para perfiles de GitHub. Depende de Upstash KV, tiene cache compartido y API REST/GraphQL.
Ficha actualizada 23 sept 2026, 9:34 · upstream 23 sept 2026, 9:18 · release sin release detectada
Qué es gh-stats
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
gh-stats es un servicio minimalista y ligero construido con Next.js, React y TypeScript que genera tarjetas SVG personalizadas para los READMEs de repositorios en GitHub. Permite elegir entre nueve tipos de tarjeta (resumen, lenguajes, streak, impacto, repositorios, enfoque, repositorio pin, gist y WakaTime), un registro centralizado de temas, colores personalizados y múltiples layouts de gráficos. El servicio ofrece estadísticas como estrellas, forks, repositorios, seguidores, contribuciones por año, calorías de contribución, repositorios enfocados, gists públicos y métricas de WakaTime. Incluye una interfaz de diseño adaptable a modo claro/oscuro con soporte para HTML y Markdown.
- Generar tarjetas SVG personalizadas en los READMEs de proyectos personales o corporativos
- Visualizar estadísticas de repositorios públicos (estrellas, forks, contribuciones) sin requerir token
- Crear dashboards visuales con métricas como streak de commits, impacto por categoría de lenguaje y WakaTime
- Publicar tarjetas estáticas que se actualizan automáticamente cada 24 horas con datos frescos
- Generar reportes de repositorios enfocados o gists públicos para análisis de código abierto
- API REST y GraphQL separadas, con soporte para token opcional en endpoints específicos como contribuciones
- Cache compartido diário en KV que reduce llamadas a GitHub y optimiza rendimiento
- Soporte nativo de modo oscuro/claro adaptativo mediante prefieres-color-scheme
- Generación de SVGs directamente desde el servidor con ETags para caché CDN eficiente
- Configuración simple vía variables de entorno (GITHUB_TOKEN, UPSTASH_REDIS_REST_URL)
- Soporte para múltiples layouts de gráficos: normal, compacto, donut y pie
- Los datos de contribuciones se basan en el rango del año pasado por defecto; no soporta agregación por años completos
- Las tarjetas de repositorios requieren un token para acceso a métricas detalladas (commits, issues)
- El cache compartido tiene límites de cuota diarios según el plan de Vercel
- No se actualizan los datos en tiempo real; hay una ventana de 24 horas entre refrescos
- Las tarjetas de WakaTime solo muestran estadísticas públicas del usuario, no las privadas
- El servicio depende de infraestructura externa (Upstash KV) para el cache compartido
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.
Instala Node.js 24 y ejecuta `npm ci` seguido de `npm run dev`. Configura `.env.local` con GITHUB_TOKEN, UPSTASH_REDIS_REST_URL y UPSTASH_REDIS_REST_TOKEN. Usa la variable NEXT_PUBLIC_SITE_URL para el URL público. Para producción en Vercel, conecta Git y despliega usando su pipeline automático o la ruta manual `/deploy/production`. No se requiere token para las tarjetas de resumen; solo para endpoints GraphQL con contribuciones. Monitorea CPU, memoria y uso de KV en Vercel Dashboard. El prebuild estático genera los SVGs diarios mediante un script que valida el batch completo antes de reemplazar archivos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.