How to Add GitHub Streak Stats to Your Profile README

The streak stats card is an SVG image generated by the streak-stats.demolab.com service. It reads your public GitHub contribution history and displays three sections: the left shows your current active streak in days, the center shows your longest streak ever recorded, and the right shows your total contribution count across all years.

The card uses the same contribution data as GitHub's native contribution graph, meaning it counts commits to default branches, pull requests opened, issues created, and code reviews. It does not count contributions to non-default branches unless those branches are later merged. Like the native graph, it resets at midnight in your configured time zone.

Adding the streak card requires a single line of markdown. Replace YOUR_USERNAME with your GitHub username:

[![GitHub Streak](https://streak-stats.demolab.com?user=YOUR_USERNAME&theme=tokyonight)](https://git.io/streak-stats)

The card is commonly placed side by side with the github-readme-stats card using an HTML div:

<div align="center">
  <img src="https://streak-stats.demolab.com?user=YOUR_USERNAME&theme=tokyonight" height="150" />
  <img src="https://github-readme-stats.vercel.app/api?username=YOUR_USERNAME&theme=tokyonight" height="150" />
</div>

The height="150" attribute ensures both cards align to the same height for a clean two-column layout.

The streak card has its own theming system separate from github-readme-stats. Common themes that match popular README color schemes:

• tokyonight — dark navy with cyan/purple accents (most popular)
• dark — plain dark background with white text
• highcontrast — high visibility black and white
• radical — pink and purple gradient on dark background
• dracula — purple-highlighted dark theme
• transparent — no background, blends with GitHub page background

Additional parameters:

• hide_border=true — removes the card border
• date_format=j/n[Y] — changes the date format
• mode=weekly — shows weekly streak instead of daily
• exclude_days=Sun,Sat — excludes specific days from streak calculation (useful if you don't code on weekends)

If the card shows 0 streak even when you have recent contributions, the service may be experiencing a rate limit or cache delay. Wait a few minutes and reload. GitHub contribution data has a propagation delay — commits made in the last few hours may not appear yet.

If the card throws an error about the user not being found, verify your username is spelled correctly (case matters). The streak-stats service uses the GitHub API and respects GitHub's rate limits — if you see a 'Failed to generate' message, it usually resolves within a few minutes without intervention.

For developers with consistent private repo activity, note that private contributions are not counted unless you have enabled 'Include private contributions on my profile' in your GitHub profile settings.