Skip to content

README.md

Latest commit

 

History

History
163 lines (115 loc) · 5.66 KB

README.md

File metadata and controls

163 lines (115 loc) · 5.66 KB
Raw
GitCity on PeerPush Featured on Product Hunt Review GitCity on Product Hunt

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.

Isometric      Heatmap      Simulation

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

Terminal

Option B

Terminal

Table

Contributing

PRs welcome. Open an issue first for major changes.

Terminal

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.

Support on Ko-fi

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