DEV Community

Cover image for The story of visitor-badge

Posted on

The story of visitor-badge

Hello every one!

In this post, I will tell you the story of me to creating the visitor-badge, it's a svg image that can count your visitors for your GitHub, issues, PRs in just one line markdown code.

Since the GitHub profile README feature, it can also count the visitors for your GitHub profile page(✌️). See my profile page for a demo


All the story starting from I migrate all my blog posts from Hexo GitHub Pages to a GitHub issue based repository. After a painful migration, I found that there is no visitor tracking for the repository, though basically I myself am the only one visitor in most time :(, I still want a visitor counting service for my every GitHub Issue and the README.


After a lot of searching, brainstorming, prototyping, I put my eye on the little badge in many other repository. Those badges can show us:

  • How much stars of the repository
  • How much opened issues
  • How much PRs
  • Latest version of npm package
  • CI status
  • ...

and all the badges is just a svg image file with a dynamic content in it.

After more searching, I found the pybadge library which will generate a GitHub badge style dynamically with a very simple api.

So I can setup a python server, receive a svg file request, generate a dynamic svg file, return it, so it will display on the

What else? A database to store the previous count of each page so that in the next time the same request from the page received, I can increment 1 based on the previous count.

Here it is:, a free counting API allows you to create simple numeric counters. IaaS, Integer as a Service. 🎉

CountAPI is a perfect chosen for this use case, and it's easy to use, I don't need to prepare a database(SQLite, MySQL, etc.), I just send a http request to the API, and can get the incremented number.

Also can avoid concurrent updating issue if too many visitors to your page in the same time, it will count them correctly, because the CountAPI is based on Redis.

So, for now, we have all we needed, just coding:

GitHub logo jwenjian / visitor-badge

[Service is DOWN now] A badge generator service to count visitors of your markdown file.

Some tricks

Why you have to pass a page_id as a query parameter?

For the first version, I plan to use the Referrer header in http request which is more convenient but GitHub proxy all the image request via its camo image server:

Your browser -> Github Camo -> My server

But Camo does not pass the Referrer header to my server for some reason, so I change to the query parameter solution.

How to deal with the image cache?

As you know, browser often caches images and in our case GitHub Camo also caches images.

Cache is good for us in most time, but for a badge to count visitor, it is a disaster because if the previous badge image are cached, there is no new request to my server and the count will not have chance the increment until the cache is invalid, that's not what we want.

We want every time every one visitor our the count will increment 1, so I did a trick thing:

  • Disable cache by adding a response header: 'Cache-Control': 'no-cache,max-age=0'

  • Set a passed expire time to 10 minutes AGO of current time: 'Expires': <10 minutes ago>

That's it, after this little tricks every time you visitor the, the browser(and camo) will know that the cached image is invalidated then send a request to my server to get the latest count.

So many words, hope my not very good English make things clear. :)

Also I launched Visistor Badge on ProductHunt too, so If you found this useful, you can consider give it a vote.

Visitor count badge for your Github Repo - A github badge to count visitor to your repository | Product Hunt Embed

Also you can use Hits, which is a similar visitor badge with a more stable service I think, because my service is now deployed under a free version of, so your choice.

I will see you in my next post.

Top comments (5)

groverception profile image
Anuj Grover 👨🏻‍💻

Thanks jiang.
I was also trying the counter on my profile

firstly i used my route without cache control and embedded the svg in github read me -> which results into forever cache of camo server.

I tried many things on the same route but my changes are not received by camo server because they already cached it with old headers
so i changed my route which changes their cache headers for my new server path hence reflecting the changes. 🎉 :)

1link profile image

Hi Anuj,


Yes, once the camo server cached the svg, you will not receive request to increment the counter until the cache is invalid, change server path is a good solution.

rahulrai profile image
Rahul Rai

I created a configurable visitor counter as well. It beats cache and runs on Azure Functions.

1link profile image

Another words is about the glitch website, I am using the MVP.css a no-class css framework to build beautiful website in just HTML tag.

1link profile image

🎉 It's in GitHub Trending! 🎉

It's in GitHub Trending!