Skip to content

simple Node.js script that generates artificial commit history to paint the GitHub contribution graph

Notifications You must be signed in to change notification settings

muxx3/commitGen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Contribution Art Generator

This project is a simple Node.js script that generates artificial commit history to paint the GitHub contribution graph — useful for creating pixel art or writing text (like your name!) using the green squares on your GitHub profile.

This script makes 100 commits for every day of the year 2006, using backdated Git commits. The commits are pushed to a connected Git repository and visually render patterns (e.g., text or shapes) in the GitHub contributions graph.

Git Commit Art

Requirements

Node.js (v18+ recommended)

Git (installed and accessible in PATH)

A new or existing GitHub repository

Project Structure

index.js – the script that generates and commits changes daily.

data.json – temporary file written to with each commit.

package.json – dependency and metadata config.

How to Use

  1. Clone a Private Repository

type 'git clone git@github.com:muxx3/commitGen.git' in your terminal

cd commitGen

  1. Install Dependencies

npm install

  1. Run the Script

node index.js

⚠ Warning: It will take time
  1. Push the Commits

The script automatically pushes all commits to the remote repository once complete.

How It Works

Uses simple-git to automate Git.

Loops over every day of 2006.

For each day:

    Writes a JSON object to a file (data.json).

    Commits that file up to 100 times with backdated timestamps.

Pushes all commits to the remote repo.

Customization Ideas

Modify makeCommitsForDay(date, count) to vary commit counts per day.

Use a 2D matrix to "draw" text or shapes by mapping dates to commit intensity.

Target different years by changing START_DATE and END_DATE.

License

MIT or do-what-you-want.

Let me know if you’d like a version with ASCII preview or an art matrix feature next.

Credits

Made with JS by  muxx3

About

simple Node.js script that generates artificial commit history to paint the GitHub contribution graph

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published