github-contribution-art

Fill your GitHub contribution graph with pixel art — each year's graph spells out that year's number in dark green squares on a light green background.

2019 → "2019" in dark green
2020 → "2020" in dark green
...

Prerequisites

1. Node.js 18+ — nodejs.org
2. Git — git-scm.com
3. A public GitHub repo — create one at github.com/new (name it contributions, leave it empty)
4. Git identity configured — must match your GitHub account email:

   git config --global user.name "Your Name"
   git config --global user.email "[email protected]"

5. Verified email on GitHub — go to github.com/settings/emails and confirm the email matches your git config

Usage

npx github-contribution-art

The CLI will ask you:

1. Which years to fill — multiselect from 2015 to current year (2019–2025 pre-selected)
2. GitHub repo URL — e.g. https://github.com/yourname/contributions.git
3. Confirmation — shows total commit count before doing anything destructive

Then it creates backdated commits locally and force-pushes to your repo. Takes ~20–30 minutes. Your GitHub graph updates within a few minutes of the push.

How it works

• Light green squares = 3 commits/day (background fill)
• Dark green squares = 15 commits/day (year number pixels)
• Uses a 5×7 pixel font centred in the 52-week contribution graph
• Commits use GIT_AUTHOR_DATE / GIT_COMMITTER_DATE to backdate

Notes

• The local working repo is created at ~/contributions-filler and is reset on every run (it is disposable — the real output is on GitHub)
• Force-push overwrites whatever is on the remote's main branch — use a dedicated repo
• GitHub counts contributions from commits where the author email matches a verified account email

Made with ❤️ in UK