GitCity

¿Qué es GitCity?

GitCity convierte el historial de contribuciones de un usuario de GitHub en un skyline de ciudad 3D isométrico interactivo. La idea principal es que cada día de contribuciones públicas se convierte en un “edificio”, con la actividad de commits influyendo en la altura, permitiéndote explorar tu actividad de forma visual en lugar de como una cuadrícula.

Está pensado para usuarios de GitHub que quieran presentar datos de contribuciones en un formato más atractivo —como insertar un SVG en un README o portfolio de desarrollador— sin configuración manual más allá de ingresar un nombre de usuario de GitHub.

Características principales

• Ciudad 3D isométrica interactiva desde contribuciones de GitHub: Construye un skyline basado en la actividad pública de contribuciones para que los espectadores entiendan patrones de un vistazo.
• Simulación de ciudad navegable: Incluye un modo de simulación donde puedes navegar la ciudad “a nivel de calle” para examinar el skyline espacialmente.
• Cambio de temas (6 temas): Ofrece visuales temáticos como Matrix, Noir, Aurora, Ocean, Gold e Ice para adaptarse a diferentes preferencias estéticas.
• Filtrado por año, mes o semana: Te permite limitar la visualización a rangos de tiempo específicos en lugar de mostrar solo el historial completo.
• SVG insertable para README de GitHub y portfolios: Genera un SVG insertable para incluir la visualización en perfiles de desarrolladores y páginas de proyectos.
• Cero configuración con nombre de usuario de GitHub: Usa el nombre de usuario ingresado para obtener datos de contribuciones públicas automáticamente, reduciendo pasos de configuración.

Cómo usar GitCity

1. Abre GitCity e ingresa tu nombre de usuario de GitHub.
2. GitCity obtiene tus datos de contribuciones públicas y renderiza la ciudad donde los días con commits aparecen como edificios.
3. Usa los controles de temas para cambiar la apariencia y los controles de filtros para enfocarte en un año, mes o semana.
4. Si quieres compartirlo, usa la opción de SVG insertable para generar un embed para tu README de GitHub o portfolio de desarrollador.
5. (Opcional) Cambia a modo de simulación y recorre la ciudad para explorarla a nivel de calle.

Casos de uso

• Visualización en README personal de GitHub: Inserta el SVG generado en un README para mostrar la actividad de contribuciones como un skyline 3D en lugar de un gráfico estático.
• Presentación en portfolio: Incluye la visualización de la ciudad en una página de portfolio de desarrollador para ofrecer una vista general de la actividad de codificación.
• Revisión por período de tiempo (mensual o semanal): Filtra por mes o semana para revisar cómo cambia el volumen de contribuciones en períodos más cortos.
• Narrativa de actividad por estética: Cambia temas (p. ej., Noir o Aurora) al presentar tu skyline en contextos diferentes como páginas de proyectos o perfiles sociales.
• “Recorrido” exploratorio de contribuciones: Usa el modo de simulación para navegar la ciudad e interpretar visualmente patrones en la densidad de commits.

Preguntas frecuentes

• ¿Qué datos usa GitCity? GitCity obtiene datos de contribuciones públicas de GitHub para el nombre de usuario que ingresas.

• ¿Cómo mapea GitCity los commits a la ciudad 3D? Según la página, cada día con commits se convierte en un edificio, y cuantos más commits, más alta la torre.

• ¿Puedo limitar la visualización a un rango de tiempo específico? Sí. GitCity incluye filtros para año, mes o semana.

• ¿Puedo insertar la visualización en otras páginas? Sí. GitCity ofrece un SVG insertable pensado para README de GitHub y portfolios de desarrolladores.

• ¿Necesito configurar algo más allá de mi nombre de usuario de GitHub? La página describe la configuración como cero configuración aparte de ingresar un nombre de usuario de GitHub.

Alternativas

• Visualizaciones de contribuciones de GitHub (mapas de calor 2D/gráficos): En lugar de una ciudad 3D y simulación, estas alternativas suelen presentar contribuciones como cuadrículas o gráficos; son más simples pero menos espaciales.
• Widgets de estadísticas de GitHub para portfolio/estáticas: Herramientas que generan insignias o resúmenes estáticos pueden ser más fáciles de insertar, pero generalmente no ofrecen la experiencia de recorrido por la ciudad ni vista 3D con filtros temporales descrita aquí.
• Visualización personalizada construida con datos de la API de GitHub: Un enfoque DIY puede producir visuales a medida (incluyendo 3D), pero traslada el esfuerzo de configuración y mantenimiento al usuario en lugar de usar un flujo de cero configuración.