srizzon / git-city
Your GitHub profile as a 3D pixel art building in an interactive city
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing srizzon/git-city in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Overview (README excerpt)
Crawler viewGit City Your GitHub profile as a 3D pixel art building in an interactive city. thegitcity.com --- What is Git City? Git City transforms every GitHub profile into a unique pixel art building. The more you contribute, the taller your building grows. Explore an interactive 3D city, fly between buildings, and discover developers from around the world. Features • **3D Pixel Art Buildings** — Each GitHub user becomes a building with height based on contributions, width based on repos, and lit windows representing activity • **Free Flight Mode** — Fly through the city with smooth camera controls, visit any building, and explore the skyline • **Profile Pages** — Dedicated pages for each developer with stats, achievements, and top repositories • **Achievement System** — Unlock achievements based on contributions, stars, repos, referrals, and more • **Building Customization** — Claim your building and customize it with items from the shop (crowns, auras, roof effects, face decorations) • **Social Features** — Send kudos, gift items to other developers, refer friends, and see a live activity feed • **Compare Mode** — Put two developers side by side and compare their buildings and stats • **Share Cards** — Download shareable image cards of your profile in landscape or stories format How Buildings Work | Metric | Affects | Example | |----------------|-------------------|----------------------------------------| | Contributions | Building height | 1,000 commits → taller building | | Public repos | Building width | More repos → wider base | | Stars | Window brightness | More stars → more lit windows | | Activity | Window pattern | Recent activity → distinct glow pattern | Buildings are rendered with instanced meshes and a LOD (Level of Detail) system for performance. Close buildings show full detail with animated windows; distant buildings use simplified geometry. Tech Stack • **Framework:** Next.js 16 (App Router, Turbopack) • **3D Engine:** Three.js via @react-three/fiber + drei • **Database & Auth:** Supabase (PostgreSQL, GitHub OAuth, Row Level Security) • **Payments:** Stripe • **Styling:** Tailwind CSS v4 with pixel font (Silkscreen) • **Hosting:** Vercel Getting Started Open http://localhost:3001 to see the city. Environment Setup After copying to , fill in these values: • , , • • if you want access to Where to find the Supabase values Open your Supabase project dashboard, then go to . • : your project URL • : the public anon key • : the service role key for server-side admin access For local GitHub login to work, you also need to configure the GitHub OAuth provider in Supabase and add your local callback URL if required by your setup. Where to find the GitHub token Open GitHub and go to . • Fine-grained tokens are recommended if you only want to grant the minimum repository/profile access this app needs. • Classic tokens also work if that fits your setup better. Create a token, copy it once, and place it in inside . License AGPL-3.0 — You can use and modify Git City, but any public deployment must share the source code. --- Built by @samuelrizzondev