Display your total contributions, current streak,
and longest streak on your GitHub profile README
- Copy-paste the markdown below into your GitHub profile README
- Replace the value after
?user=with your GitHub username
[](https://git.io/streak-stats)- Star the repo 😄
Note See below for customization options and about deploying the app on your own.
Here you can customize your Streak Stats card with a live preview.
http://streak-stats.demolab.com/demo/
The user field is the only required option. All other fields are optional.
If the theme parameter is specified, any color customizations specified will be applied on top of the theme, overriding the theme's values.
| Parameter | Details | Example |
|---|---|---|
user |
GitHub username to show stats for | DenverCoder1 |
theme |
The theme to apply (Default: default) |
dark, radical, etc. 🎨➜ |
hide_border |
Make the border transparent (Default: false) |
true or false |
border_radius |
Set the roundness of the edges (Default: 4.5) |
Number 0 (sharp corners) to 248 (ellipse) |
background |
Background color | hex code without # or css color |
border |
Border color | hex code without # or css color |
stroke |
Stroke line color between sections | hex code without # or css color |
ring |
Color of the ring around the current streak | hex code without # or css color |
fire |
Color of the fire in the ring | hex code without # or css color |
currStreakNum |
Current streak number | hex code without # or css color |
sideNums |
Total and longest streak numbers | hex code without # or css color |
currStreakLabel |
Current streak label | hex code without # or css color |
sideLabels |
Total and longest streak labels | hex code without # or css color |
dates |
Date range text color | hex code without # or css color |
date_format |
Date format (Default: M j[, Y]) |
See note below on 📅 Date Formats |
locale |
Locale to use for labels (Default: en) |
ISO 639-1 code - See 🗪 Locales |
type |
Output format (Default: svg) |
Current options: svg, png or json |
mode |
Streak mode (Default: daily) |
daily (contribute daily) or weekly (contribute once per Sun-Sat week) |
To enable a theme, append &theme= followed by the theme name to the end of the source URL:
[](https://git.io/streak-stats)| Theme | Preview |
|---|---|
default |
 |
dark |
 |
highcontrast |
 |
| More themes! | 🎨 See a list of all available themes |
If you have come up with a new theme you'd like to share with others, please see Issue #32 for more information on how to contribute.
en - English | ar - العربية | bg - български | bn - বাংলা | es - español |
fa - فارسی | fr - français | he - עברית | hi - हिन्दी | ja - 日本語 |
ko - 한국어 | mr - मराठी | pl - polski | ps - پښتو | pt_BR - português (Brasil) |
ru - русский | uk - українська | yo - Èdè Yorùbá | zh_Hans - 中文（简体） | zh_Hant - 中文（繁體） |
da - dansk | de - Deutsch | id - Indonesia | it - italiano | kn - ಕನ್ನಡ |
nl - Nederlands | ta - தமிழ் | tr - Türkçe | vi - Tiếng Việt |
If you would like to help translate the Streak Stats cards, please see Issue #236 for more information.
A custom date format can be specified by passing a string to the date_format parameter.
The required format is to use format string characters from PHP's date function with brackets around the part representing the year.
When the contribution year is equal to the current year, the characters in brackets will be omitted.
Examples:
| Date Format | Result |
|---|---|
d F[, Y] |
"2020-04-14" => "14 April, 2020" |
j/n/Y |
"2020-04-14" => "14/4/2020" |
[Y.]n.j |
"2020-04-14" => "2020.4.14" |
M j[, Y] |
"2020-04-14" => "Apr 14, 2020" |
[](https://git.io/streak-stats)This tool uses the contribution graphs on your GitHub profile to calculate which days you have contributed.
To include contributions in private repositories, turn on the setting for "Private contributions" from the dropdown menu above the contribution graph on your profile page.
Contributions include commits, pull requests, and issues that you create in standalone repositories.
The longest streak is the highest number of consecutive days on which you have made at least one contribution.
The current streak is the number of consecutive days ending with the current day on which you have made at least one contribution. If you have made a contribution today, it will be counted towards the current streak, however, if you have not made a contribution today, the streak will only count days before today so that your streak will not be zero.
Note You may need to wait up to 24 hours for new contributions to show up (Learn how contributions are counted)
If you can, it is preferable to host the files on your own server.
Doing this can lead to better uptime and more control over customization (you can modify the code for your usage).
You can deploy the PHP files on any website server with PHP installed or as a Heroku app.
The Inkscape dependency is required for PNG rendering, as well as Segoe UI font for the intended rendering. If using Heroku, the buildpacks will install these for you automatically.
Heroku costs around $5-$7/month minimum for a single app, but you can contact the Open Source program at [email protected] to possibly get free credits.
Instructions for Deploying to Heroku
- Sign in to Heroku or create a new account at https://heroku.com
- Visit this link to create a new Personal Access Token (no scopes required)
- Scroll to the bottom and click "Generate token"
- Click the Deploy button below
- Add the token as a Config Var with the key
TOKEN:
- Click "Deploy App" at the end of the form
- Once the app is deployed, you can use
<your-app-name>.herokuapp.comin place ofstreak-stats.demolab.com
Vercel is a free hosting service that can be used to run PHP. Note: The intl library seems to not be available through Vercel at the moment (vercel-community/php#367), so the automatic number and date formats for locales other than English will not work. PNG mode is also not supported since Inkscape will not be installed.
Instructions for Deploying to Vercel for Free
- Sign in to Vercel or create a new account at https://vercel.com
- Clone this repository with
git clone https://github.com/DenverCoder1/github-readme-streak-stats.git- You may also fork the repository and clone your fork instead if you intend to make changes
- Enter the directory with
cd github-readme-streak-stats - Switch branches to the
vercelbranch withgit checkout vercel - Make sure you have the Vercel CLI installed
- Run
verceland follow the prompts to link your Vercel account and select a project name - The app will be deployed to
<project-name>.vercel.app - Visit this link to create a new Personal Access Token (no scopes required)
- Scroll to the bottom and click "Generate token"
- Visit the Vercel dashboard and select your project, then click "Settings", then "Environment Variables".
- Add a new variable with the key
TOKENand the value as your token from step 9 and click "Save".
Note
To set up automatic Vercel deployments from GitHub, make sure to turn off "Include source files outside of the Root Directory" in the General settings and usevercelas the production branch in the Git settings.
Contributions are welcome! Feel free to open an issue or submit a pull request if you have a way to improve this project.
Make sure your request is meaningful and you have tested the app locally before submitting a pull request.
Refer to CONTRIBUTING.md for more details on contributing, installing requirements, and running the application.
💙 If you like this project, give it a ⭐ and share it with friends!
Made with ❤️ and PHP
