What is GitCity?

GitCity fetches your entire GitHub contribution history via the GitHub GraphQL API and renders it as an interactive 3D city — no token required, no login, no paywall.

         

---

Embed API

Drop a live, always-updated skyline anywhere — README, portfolio, blog post.

[![My GitCity Skyline](https://gitcity.natrajx.in/api/svg?u=YOUR_USERNAME)](https://gitcity.natrajx.in/YOUR_USERNAME)

HTML — full control

<a href="https://gitcity.natrajx.in/YOUR_USERNAME">
  <img src="https://gitcity.natrajx.in/api/svg?u=YOUR_USERNAME&theme=aurora"
       alt="My GitHub Skyline" width="100%" />
</a>

iframe — interactive, for portfolios

<iframe
  src="https://gitcity.natrajx.in/YOUR_USERNAME/isometric"
  width="100%" height="500"
  frameborder="0"
  title="GitHub Contribution Skyline">
</iframe>

---

Quick Start

Option A

Option B

Contributing

PRs welcome. Open an issue first for major changes.

---

Support

GitCity is free and open-source — no login, no paywall, no token required for the hosted version.

If it made your README cooler or your portfolio stand out, consider a coffee. It goes toward hosting, GPU time, and building more free tools.

---

FAQ

Is this the same as thegitcity.com?
No — completely different project. See COMPARISON.md for a full breakdown.

Do I need a GitHub token?
No. The hosted version at gitcity.natrajx.in handles auth server-side. Token only needed for self-hosting.

Can I share someone else's city?
Yes — just use their username in the URL. All data is public GitHub contribution data.

---

Made with coffee by Rishabh Bhartiya