Skip to content

remvze/gitviews

Repository files navigation

GitViews ✨

Super simple GitHub view counter.

GitHub Repo Views


Badges 🏅

Profile Views

URL

https://gitviews.com/user/<your-github-username>.svg

Markdown

![GitHub Profile Views](https://gitviews.com/user/<your-github-username>.svg)

Note

Please replace <your-github-username> with your GitHub username (without @).


Repo Views

URL

https://gitviews.com/repo/<your-username>/<your-repo>.svg

Markdown

![GitHub Repo Views](https://gitviews.com/repo/<your-username>/<your-repo>.svg)

Note

Please replace <your-username> with your GitHub username (without @), and <your-repo> with your repository name.


All Repos Views

URL

https://gitviews.com/user/<your-github-username>/repos.svg

Markdown

![GitHub Repos Views](https://gitviews.com/user/<your-github-username>/repos.svg)

Note

Please replace <your-github-username> with your GitHub username (without @).


Migrating From Another Counter

The base parameter allows you to add an existing number to the live view count. This is useful if you're migrating from another service and want to preserve your previous total.

Important:

  • GitViews does not store the sum, only the real count.
  • The base value must remain in the URL permanently to keep the adjusted total correct.

Example:

If your previous tracker recorded 3,200 views, you can carry that over:

https://gitviews.com/repo/<user>/<repo>.svg?base=3200

Customization 🎨

GitViews badges support several customization parameters, allowing you to style badges to match your theme.

You can add these as query parameters (?key=value) to any badge URL.

Available Parameters

style

Controls the overall badge style.

Options:

  • flat
  • flat-square
  • for-the-badge
  • social
  • plastic

Example:

https://gitviews.com/user/<your-username>.svg?style=for-the-badge

label

Set the label of the badge.

Example:

https://gitviews.com/user/<user>.svg?label=Views

label-color

Sets the background color of the badge label. Accepts hex, rgb, or color names.

Example:

https://gitviews.com/repo/<user>/<repo>.svg?label-color=blue
https://gitviews.com/repo/<user>/<repo>.svg?label-color=%23ff8800

Note

(Use %23 for # in URLs.)


color

Sets the color of the value / counter portion of the badge.

Example:

https://gitviews.com/user/<your-username>/repos.svg?color=green

Combined Example

https://gitviews.com/user/<your-username>.svg?style=flat-square&label-color=%23000&color=%23ff00ff
![GitHub Profile Views](https://gitviews.com/user/<your-username>.svg?style=flat-square&label-color=%23000&color=%23ff00ff)