srizzon/git-city
Git City
Git City transforms a GitHub profile into a unique 3D pixel art building whose height, width, and window brightness reflect contribution activity, repository count, and star totals. The project renders these buildings as voxel-based structures in a shared 3D city scene, using a custom geometry generator that maps GitHub metrics to block dimensions and colors.
Users can explore this interactive city by flying through it with smooth camera controls, visiting any developer's building to view their statistics. The project also enables side-by-side comparisons of two profiles, placing their buildings and metrics in a shared scene with synchronized camera controls. A gamified achievement system awards badges for reaching milestones in contributions, stars, repositories, and referrals, while a cosmetic attachment system lets users personalize claimed buildings with purchased items like crowns, auras, and roof effects.
The project includes a shareable image generator that captures the 3D viewport and overlays profile statistics onto a downloadable image card in landscape or stories format. All data is fetched and cached through the GitHub REST API, transforming contribution stats into building parameters on demand.
Features
- 3D Building Visualizations - Transforms GitHub profiles into unique 3D pixel art buildings whose dimensions reflect contribution activity and repository stats.
- GitHub Profile Integrations - Transforms GitHub profile data into 3D pixel art buildings as a core visualization integration.
- Profile Data Pipelines - Fetches GitHub profile data and transforms contribution stats into building parameters for 3D visualization.
- Developer Profile Comparisons - Places two GitHub profiles as 3D buildings side by side for direct visual and metric comparison.
- Developer Activity Achievements - Awarding achievements for reaching milestones in contributions, stars, repositories, and referrals to motivate developer activity.
- Interactive Developer City Explorers - Provides an interactive 3D city fly-through to explore developer profiles and view their statistics.
- Metric-Driven Voxel Renderers - Transforms GitHub metrics into 3D voxel buildings as the core visualization mechanism.
- Metric-Driven Voxel Generators - Maps GitHub contribution counts, repository numbers, and star totals to voxel block positions and colors.
- Interactive City Scene Graphs - Organizes buildings in a Three.js scene graph with collision boundaries and raycasting for interactive selection.
- Milestone Evaluators - Provides a declarative rule engine for evaluating user activity milestones and awarding badges.
- Milestone Unlockers - Implements a framework that evaluates user milestones to unlock achievement badges and visual rewards.
- GitHub Milestone Evaluators - Award achievements based on contributions, stars, repositories, referrals, and other milestones to gamify developer activity.
- Profile Image Card Generators - Creates a downloadable shareable image of a developer's profile in landscape or stories format.
- Synchronized 3D Viewports - Synchronizes camera controls and metric overlays across two viewports for direct 3D building comparison.
- Cosmetic Attachments - Customizing a claimed building with purchased crowns, auras, roof effects, and face decorations for a unique look.
- Profile Statistics - Generating a downloadable image of a developer's profile in landscape or stories format for social media sharing.
- 3D Profile Comparisons - Places two developers' 3D buildings side by side with synchronized cameras for direct visual comparison.
- Fly-Through Camera Controllers - Provides a fly-through camera with collision detection and raycasting for selecting buildings in the 3D city.
