Skip to content

README.md

Latest commit

 

History

History
154 lines (93 loc) · 5 KB

README.md

File metadata and controls

154 lines (93 loc) · 5 KB

🏆 GitHub Contribution Showcase API

A GitHub GraphQL-based Trophy API that displays a user’s real GitHub name (or username if no name is set), along with accurate contribution streaks, active days, and total contributions — all shown in clean, polished SVG widgets.

Uses GitHub’s official GraphQL API — no scraping and no fake statistics.

🆚 How is this different from other GitHub trophy tools?

Most GitHub trophy or stats tools rely on scraped data or focus mainly on visuals.

This project is different because it:

  • Uses GitHub’s official GraphQL API for accurate and reliable data
  • Avoids scraping and fake statistics
  • Focuses on clean, readable SVG output
  • Highlights meaningful metrics like streaks and active days

🎨 Theme Gallery & Quick Setup

Pick a design you like and copy the code below into your GitHub Profile README.

Note: Replace YOUR_USERNAME with your actual GitHub username.

1. 🟢 Neon Glassmorphism (Default)

A classic glowing design with smooth animations.

Neon Preview

[![GitHub Trophy](https://personal-trophy.vercel.app/api?username=YOUR_USERNAME&theme=neon)](https://github.com/ayushraistudio/github-contribution-showcase)

2. 🟣 Cyberpunk 2077

A high-contrast, futuristic theme for tech enthusiasts.

Cyberpunk Preview

[![GitHub Trophy](https://personal-trophy.vercel.app/api?username=YOUR_USERNAME&theme=cyberpunk)](https://github.com/ayushraistudio/github-contribution-showcase)

3. 🟡 Luxury Gold

A premium, elegant look for a standout GitHub profile.

Gold Preview

[![GitHub Trophy](https://personal-trophy.vercel.app/api?username=YOUR_USERNAME&theme=gold)](https://github.com/ayushraistudio/github-contribution-showcase)

4. 🌸 Midnight Sakura

An elegant dark theme with soft pink highlights.

Sakura Preview

[![GitHub Trophy](https://personal-trophy.vercel.app/api?username=YOUR_USERNAME&theme=sakura)](https://github.com/ayushraistudio/github-contribution-showcase)

5. 📟 Matrix Hacker

A terminal-style theme for a classic hacker aesthetic.

Matrix Preview

[![GitHub Trophy](https://personal-trophy.vercel.app/api?username=YOUR_USERNAME&theme=matrix)](https://github.com/ayushraistudio/github-contribution-showcase)

6. 🔥 Hacker / Cyber Neon Theme

A futuristic theme with glowing filled boxes (pink, blue, and yellow) on a dark gradient background.

Hacker Preview

[![GitHub Trophy](https://personal-trophy.vercel.app/api?username=YOUR_USERNAME&theme=hacker)](https://github.com/ayushraistudio/github-contribution-showcase)

🚀 Why use this API instead of other tools?

  • Live Updates: Always shows your latest GitHub stats—no manual updates needed
  • Fast Performance: Built with Vercel Serverless Functions for quick load times
  • Click to Discover: Clicking the trophy takes users to this repository so they can set it up themselves

🛠️ Installation for Developers

If you want to host your own version of this API:

  1. Fork this repository
  2. Deploy it on Vercel
  3. Add your GITHUB_TOKEN as an Environment Variable

🤝 Contributing

Contributions help make the open-source community a great place to learn, build, and share. Any contribution you make is greatly appreciated.

Please see CONTRIBUTING.md for more details.

💬 Discussions & Community

Have questions, ideas, or feedback?
Join the discussion here:
👉 https://github.com/ayushraistudio/github-contribution-showcase/discussions

📄 License

This project is distributed under the MIT License. See LICENSE for more information.

Made with ❤️ by Ayush Rai