DEV Community

Cover image for I built a free GitHub-profile / GitHub-repo view counter
Piyush Kokane
Piyush Kokane

Posted on

I built a free GitHub-profile / GitHub-repo view counter

I used to use antonkomarev's profile-views-counter, but it has limited customizability.
So I built my own — it tracks how many times your GitHub profile or repo has been visited.

━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛠️ How to use?

Just add this to your profile / repo README:

![](https://view-counter-livid.vercel.app/api?username=your-username)

That's it. No signup, no API key — Starts counting immediately.

━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ Features:

  • Profile + repo counter — each gets its own count
  • 3 layouts — horizontal, vertical, split
  • 4 styles — rounded, square, no background, invisible
  • Full rgba color support — including transparent backgrounds
  • Fully customizable — custom icon, label, font size, colors
  • Abbreviated counts — 12345 → 12.3K
  • Invisible mode — count silently without showing anything
  • Self-hostable in ~10 minutes — Vercel + Supabase (both free)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🆚 Quick comparison:

antonkomarev/views-counter is a most popular one out there but it has limited customizability.
I compared it here. 👇

Feature antonkomarev mine
Profile counter
Repo counter
Self-hostable
Custom label
Custom color ✅ hex only ✅ hex + rgba
Transparent background
Custom bg color
No background style
Split layout
Vertical layout
Custom icon color
Custom icon size
Hide icon
Hide label
Abbreviated counts
Base count offset
Invisible mode

━━━━━━━━━━━━━━━━━━━━━━━━━━━

The biggest differences:

  1. Repo counter — antonkomarev only tracks profiles, mine works for repos too
  2. Transparent background — antonkomarev only supports solid hex colors, mine supports full rgba + hex so you can have a fully transparent background — really useful in some cases
  3. Customization — antonkomarev has 4 fixed badge styles. Mine lets you control colors, layouts, icon, label, size and background independently

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Tech stack: Vercel + Supabase (both free tier)

Full guide + docs 👉 github.com/github-view-counter

Hope this helps,
Would love feedback and suggestions!

Top comments (1)