Code Monkey home page Code Monkey logo

github-readme-streak-stats's Introduction

Github Readme Streak Stats

Display your total contributions, current streak,
and longest streak on your GitHub profile README

๐Ÿ“ƒ Table of Contents

โšก Quick setup

  1. Copy-paste the markdown below into your GitHub profile README
  2. Replace the value after ?user= with your GitHub username
[![GitHub Streak](https://github-readme-streak-stats.herokuapp.com/?user=DenverCoder1)](https://github.com/DenverCoder1/github-readme-streak-stats)

Note: See below for information about deploying the app on your own

๐Ÿ”ง Options

Parameter Details Example
user GitHub username to show stats for DenverCoder1
theme The theme to apply (Default: default) dark, black-ice, etc. ๐ŸŽจ
hide_border Make the border transparent (Default: false) true or false
Theme Customizations Customize specific colors See Theme Customizations below

Note: The user field is the only required option. All other fields are optional.

๐Ÿ–Œ Themes

To enable a theme, append &theme= followed by the theme name to the end of the source url:

[![GitHub Streak](https://github-readme-streak-stats.herokuapp.com/?user=DenverCoder1&theme=dark)](https://github.com/DenverCoder1/github-readme-streak-stats)
Theme Screenshot
default default
dark dark
highcontrast 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, open an issue to add it!

๐Ÿ–ผ Theme customizations

These additional URL options, can be added as parameters to make customizations to the colors used.

If the theme parameter is specified, these customizations will be applied on top of the theme, overriding the theme's values.

For each of the following, a hex code (ex. F00, FFF2, 23BFC1, etc.) or css color (ex. white, forestgreen, fuchsia, etc.) can be specified. Do not use # when writing the hex code!

Parameter Details
background Background color
border Border color
stroke Stroke line color between sections
ring Color of the ring around the current streak
fire Color of the fire in the ring
currStreakNum Current streak number
sideNums Total and longest streak numbers
currStreakLabel Current streak label
sideLabels Total and longest streak labels
dates Date range text color

Example:

[![GitHub Streak](https://github-readme-streak-stats.herokuapp.com/?user=denvercoder1&currStreakNum=2FD3EB&fire=pink&sideLabels=F00)](https://github.com/DenverCoder1/github-readme-streak-stats)

โ„น How these stats are calculated

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 (Learn more about what is considered a contribution).

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)

๐Ÿ“ค Deploying it on your own

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.

Deploy

๐Ÿค— Contributing

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.

Running the app locally

Requirements: PHP 7.4+

$ sudo apt-get install php
$ sudo apt-get install php-curl
$ git clone https://github.com/DenverCoder1/github-readme-streak-stats.git
$ cd github-readme-streak-stats
$ php -S localhost:8000

Open http://localhost:8000/src?user=DenverCoder1 to test the project locally.

โ–ถ How to run PHP using XAMPP

๐Ÿ™‹โ€โ™‚๏ธ Support

๐Ÿ’™ If you like this project, give it a โญ and share it with friends!

Youtube Sponsor with Github

โ˜• Buy me a coffee


Made with โค๏ธ and PHP

Powered by Heroku

github-readme-streak-stats's People

Contributors

adityadees avatar deeshansharma avatar denvercoder1 avatar dosx001 avatar nimperx avatar phoenixcreation avatar

Stargazers

 avatar  avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.