GitCity

Qu'est-ce que GitCity ?

GitCity transforme l'historique de contributions GitHub d'un utilisateur en skyline 3D isométrique interactive. L'idée principale est que chaque jour de contributions publiques devient un « bâtiment », l'activité de commits influençant la hauteur, pour explorer votre activité visuellement plutôt qu'en grille.

Il est destiné aux utilisateurs GitHub souhaitant présenter leurs données de contributions dans un format plus engageant — comme intégrer un SVG dans un README ou un portfolio de développeur — sans configuration manuelle au-delà de la saisie d'un nom d'utilisateur GitHub.

Fonctionnalités principales

• Skyline 3D isométrique interactive à partir des contributions GitHub : Construit une skyline basée sur l'activité de contributions publiques pour que les spectateurs comprennent les tendances d'un coup d'œil.
• Simulation de ville navigable : Inclut un mode simulation où vous pouvez naviguer dans la ville « au niveau de la rue » pour examiner la skyline spatialement.
• Changement de thèmes (6 thèmes) : Propose des visuels thématiques incluant Matrix, Noir, Aurora, Ocean, Gold et Ice pour s'adapter à différents goûts esthétiques.
• Filtrage temporel par année, mois ou semaine : Permet de limiter la visualisation à des plages temporelles spécifiques plutôt que d'afficher uniquement l'historique complet.
• SVG intégrable pour README GitHub et portfolios : Génère un SVG intégrable pour inclure la visualisation sur les profils de développeurs et pages de projets.
• Zéro configuration via nom d'utilisateur GitHub : Utilise le nom d'utilisateur saisi pour récupérer automatiquement les données de contributions publiques, réduisant les étapes de configuration.

Comment utiliser GitCity

1. Ouvrez GitCity et saisissez votre nom d'utilisateur GitHub.
2. GitCity récupère vos données de contributions publiques et rend la ville où les jours avec commits apparaissent comme des bâtiments.
3. Utilisez les contrôles de thèmes pour changer l'apparence et les contrôles de filtres pour vous concentrer sur une année, un mois ou une semaine.
4. Pour partager, utilisez l'option SVG intégrable pour générer un embed pour votre README GitHub ou portfolio de développeur.
5. (Optionnel) Passez en mode simulation et conduisez dans la ville pour l'explorer au niveau de la rue.

Cas d'usage

• Visualisation pour README GitHub personnel : Intégrez le SVG généré dans un README pour afficher l'activité de contributions comme une skyline 3D plutôt qu'un graphique statique.
• Présentation de portfolio : Incluez la visualisation de la ville sur une page de portfolio de développeur pour un aperçu immédiat de l'activité de codage.
• Revue par période (mensuelle ou hebdomadaire) : Filtrez par mois ou semaine pour examiner les variations de volume de contributions sur des périodes courtes.
• Storytelling d'activité par esthétique : Changez de thèmes (ex. Noir ou Aurora) pour présenter votre skyline dans différents contextes comme des pages de projets ou profils sociaux.
• « Balade exploratoire » des contributions : Utilisez le mode simulation pour naviguer dans la ville et interpréter visuellement les motifs de densité de commits.

FAQ

• Quelles données utilise GitCity ? GitCity récupère les données de contributions GitHub publiques pour le nom d'utilisateur saisi.

• Comment GitCity mappe-t-il les commits à la ville 3D ? Selon la page, chaque jour avec commits devient un bâtiment, et plus de commits, plus la tour est haute.

• Puis-je limiter la visualisation à une plage temporelle spécifique ? Oui. GitCity inclut des filtres pour année, mois ou semaine.

• Puis-je intégrer la visualisation sur d'autres pages ? Oui. GitCity propose un SVG intégrable destiné aux README GitHub et portfolios de développeurs.

• Ai-je besoin de configurer autre chose que mon nom d'utilisateur GitHub ? La page décrit la configuration comme zéro configuration hormis la saisie d'un nom d'utilisateur GitHub.

Alternatives

• Visualisations de contributions GitHub (heatmaps/charts 2D) : Au lieu d'une ville 3D et simulation, ces alternatives présentent généralement les contributions en grilles ou graphiques ; elles sont plus simples mais moins spatiales.
• Widgets de stats GitHub statiques pour portfolios : Des outils générant badges ou résumés statiques sont plus faciles à intégrer, mais n'offrent habituellement pas l'expérience de conduite en ville ou la vue 3D par période décrite ici.
• Visualisation personnalisée à partir des données API GitHub : Une approche DIY peut produire des visuels sur mesure (y compris 3D), mais transfère l'effort de configuration et maintenance à l'utilisateur plutôt qu'un workflow zéro configuration.