See how many people use your library, with Sourcegraph badges

By Stephen Gutekanst on February 13, 2017

Update (September 20, 2017): Viewing a list of repositories that refer to another repository is currently disabled. It will be added back soon. Viewing function call sites across repositories is still supported.

As an open-source author, I love seeing who else uses my projects. It’s super motivating, and it makes the world of code feel more connected (hello to my library users in Azerbaijan and Nigeria and everywhere else!). As a user, this information helps me choose the best library to use. People usually rely on GitHub stars to see this information. But there’s a problem: stars only tell you who’s interested in a project, not who actually uses it.

Today, we’re introducing Sourcegraph “used by” badges, for you to show off how many people are using your library. Check out the sample badges below.

gorilla/mux, a powerful URL router and dispatcher for Go.boltdb/bolt, an embedded key/value database for Go.

The badges pull from the Sourcegraph global code graph and use dependency information to calculate how many other repositories import code from yours. Badges are currently available for Go projects, with support for more languages coming soon! (See the Sourcegraph Master Plan for how and why we’re building this stuff.)

How to add the badge

Adding a badge to your project is easy. Just add this Markdown to your README.md:

[![Sourcegraph](https://sourcegraph.com/github.com/gorilla/mux/-/badge.svg)](https://sourcegraph.com/github.com/gorilla/mux?badge)

(Be sure to replace github.com/gorilla/mux with your own repository's name.)

(Feb 13, 2017) Update: After popular request, we’ve also added the ability to customize the badge style. You can add any of the following to the end of the badge.svg URL:

  • ?style=plastic
  • ?style=flat
  • ?style=flat-square

1*k5hDGTDlyVE9Sq2Yy4i23g