A tool that generates a repository which being pushed into your GitHub account creates a nice contributions calendar.
Ensure you configured NPM and NodeJS not to require sudo
when installing
packages globally.
$ npm install -g gh-contributions
To start the GitHub contributions server, do:
$ gh-contributions
For this application to work well on Windows, Git must be installed with the option to put it in PATH
enabled, like in this screenshot:
If Git is not installed with this option selected, gh-contributions will not be able to generate the repository.
$ git clone git@github.com:IonicaBizau/github-contributions.git
$ cd github-contributions
$ npm install
$ npm start
The server runs on the 9000
port. Open http://localhost:9000/
in your
browser.
Click the day elements you want to have contributions. They will become green. If you want to activate smooth drawing, press Shift and hover the day elements. To clear them, click them again or activate clearing with hovering, holding the Ctrl key.
If you want to insert a text, that's even easier: insert your text in the textbox above, and click the Generate data from text button. Then to preview the generating JSON click the Toggle calendar days from data button.
pro tip: Modify the commitsPerDay
value (default is 10
) to a greater value
if you want to have more contributions per day.
Once you are ready and happy with the graph calendar you designed, press the Generate data from calendar button and then Generate repository from data.
Once the repository is generated, download the zip archive clicking the download link.
- Unzip the archive
- Create an empty repository on GitHub.
- Add the remote to your downloaded and unzipped repository.
- Do
git push --all
- Enjoy!
If you want or need to delete the graph calendar, simply delete the repository.
- Go to the settings page of your repository.
- Click Delete this repository.
- Confirm the name of the repository.
To add new things on the contributions calendar, simply create new repositories which will create graphs to overlap the others.
- File an issue in the repository, using the bug tracker, describing the contribution you'd like to make. This will help us to get you started on the right foot.
- Fork the project in your account and create a new branch:
your-great-feature
. - Commit your changes in that branch.
- Open a pull request, and reference the initial issue in the pull request message.
See the LICENSE file.