GitViews

Super simple GitHub view counter.

---

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
• modern
• modern-square
• modern-outline

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)