Frequently Asked Questions

CommitQuest turns your real GitHub history into a Pokémon-style RPG character card. Your commits, pull requests, reviews, stars and streaks become XP, a level, a character class, and unlockable achievements. The idea: make your dev work feel like a game and give you a card worth sharing.

Just type any GitHub username on the home page and hit Reveal. No login needed to view a card — yours or anyone else's.

No — viewing, downloading and sharing public cards works without an account. You only sign in (with GitHub) if you want to go Pro, customize your own card, or have your private contributions counted.

Yes — everything is free. The full card, all-time public stats, and sharing are free. Pro unlocks private stats, premium looks and power features, and it's also free — just star our GitHub repo to unlock it. See the Pro page.

XP is earned from your activity, weighted so quality counts more than raw volume: pull requests and reviews are worth more than individual commits, and long streaks give bonuses. Level uses a rising curve (it gets harder each level), and Level 50 earns the legendary "10x Mythic" title. To keep things fair, repo count is capped so spinning up empty repos won't inflate your score.

Your class comes from the language you've written the most code in. For example: TypeScript → Ranger, Python → Wizard, JavaScript → Rogue, Rust → Paladin, Go → Monk. Your top language also sets your card's color theme. No clear main language? You become a Wanderer.

Rarity is based on your level: Common (1–9), Rare (10+), Epic (20+), Legendary (30+), and Mythic (50+). Higher tiers get flashier badges.

It's your pull-request contributions as GitHub counts them across your contribution history — a measure of activity, not a lifetime count of every merged PR.

Stars are summed across the repos you own (forks excluded). Stars on other people's repos you contributed to don't count toward your total.

A couple of time-of-day achievements (like Night Owl / Early Bird) depend on the exact hour of each commit, which GitHub's public contribution data doesn't expose. Rather than guess, we leave them locked. Everything else — streaks, polyglot, PR machine, OSS hero, etc. — unlocks from real data.

Cards are cached so one fetch can serve many viewers. Free cards refresh roughly every 6 hours; Pro cards refresh about every 5 minutes ("priority refresh"), so your latest commits show up far sooner.

GitHub's own stats can take a little time to settle, and your card is cached (6h free / 5min Pro). Give it a few minutes; Pro updates the fastest.

By default only public activity is counted. If a lot of your work is in private repos, go Pro and view your own profile while signed in — your private contributions then count too (see the privacy section below).

Sign in with GitHub, then go to the Pro page and click "⭐ Star on GitHub to Get Pro". Star the CommitQuest repo, come back, and click "I've starred it — Verify". Pro activates instantly once your star is confirmed.

Yes. No credit card, no payment, no trial period. Just star the GitHub repo and you have full Pro access forever. Stars help CommitQuest get discovered — it's a fair trade.

No. Pro is verified on our server for every render. Adding things like ?theme=gold or ?scale=2 to a URL does nothing unless your account is actually Pro — so nobody can fake a Pro card.

No. Ranking is pure XP — Pro never buys you a higher spot. Pro only adds a visual 👑 highlight to your row. (Private contributions can raise your XP, but that's real activity, not a shortcut.)

No. We never read, store or display your private source code, file contents, or repo names. We only count aggregate numbers — like how many private contributions you made — to add to your totals. Private repo names are explicitly excluded from the card.

GitHub's contribution API only reveals your private contribution counts when you authorize with your own token. That consent screen looks broad, but CommitQuest only ever uses it to read your own aggregate stats when you are signed in — never anyone else's, and never the contents.

When you open your own profile while signed in, we compute your full (private-included) totals and cache them briefly. For the next few minutes, anyone viewing your card sees those aggregate numbers — without ever touching your private data themselves. Pop back to your profile any time to refresh it.

Private contributions are only included after you opt in by viewing your own signed-in Pro profile. If you never do that, your public card stays public-only. Either way, only totals — never names or code — are ever shown.

Automatically — your entry is recorded whenever your profile is viewed. The board ranks the top players by total XP. Open the leaderboard to see where you stand.

Compare puts two developers side-by-side and scores them across 9 stats (level, XP, commits, PRs, reviews, stars, streak, repos, followers), then declares a winner. It's a Pro feature — see Compare.

Yours. As long as you (the viewer) are Pro, you can compare any two public profiles — your friend doesn't need to be Pro.

On your profile, use Download (PNG), Copy link, or Share (X, LinkedIn, Facebook, Reddit, WhatsApp, or your device's native share). Pasting your profile link anywhere also shows a rich card preview.

Embed your badge image URL in your README markdown:![CommitQuest](https://YOUR-DOMAIN/api/badge/your-username)It updates automatically as your stats change. Free users get a small "upgrade to embed" placeholder instead.

Pro renders at 2× resolution (great for retina screens, slides and print), with no watermark. Free downloads are standard resolution with a small mark.