github-contribution-art 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RadosavAntonio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# 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](https://nodejs.org)
+2. **Git** — [git-scm.com](https://git-scm.com)
+3. **A public GitHub repo** — create one at [github.com/new](https://github.com/new) (name it `contributions`, leave it empty)
+4. **Git identity configured** — must match your GitHub account email:
+   ```bash
+   git config --global user.name "Your Name"
+   git config --global user.email "you@example.com"
+   ```
+5. **Verified email on GitHub** — go to [github.com/settings/emails](https://github.com/settings/emails) and confirm the email matches your git config
+
+## Usage
+
+```bash
+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

package/bin/cli.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+import { checkbox, input, confirm } from '@inquirer/prompts'
+import { homedir } from 'os'
+import { join } from 'path'
+import { buildSchedule } from '../src/art.js'
+import { checkIdentity, initRepo, makeCommit, setRemote, push } from '../src/git.js'
+
+const currentYear = new Date().getFullYear()
+
+async function main() {
+  console.log('\ngithub-contribution-art\n')
+
+  const identity = checkIdentity()
+  console.log(`Git identity: ${identity.name} <${identity.email}>\n`)
+
+  const years = await checkbox({
+    message: 'Which years to fill? (space to select, enter to confirm)',
+    choices: Array.from({ length: currentYear - 2015 + 1 }, (_, i) => {
+      const y = 2015 + i
+      return { name: String(y), value: y, checked: y >= 2019 && y <= currentYear - 1 }
+    }),
+    validate: v => v.length > 0 || 'Select at least one year',
+  })
+
+  const repoUrl = await input({
+    message: 'GitHub repo URL (e.g. https://github.com/you/contributions.git):',
+    validate: v => {
+      if (!v.includes('github.com')) return 'Enter a valid GitHub URL'
+      if (v.includes('username/')) return 'Replace "username" with your actual GitHub username'
+      return true
+    },
+  })
+
+  const repoDir = join(homedir(), 'contributions-filler')
+
+  console.log('\nBuilding schedule...')
+  const schedule = buildSchedule(years)
+  const dates = [...schedule.keys()].sort()
+  const total = [...schedule.values()].reduce((a, b) => a + b, 0)
+  console.log(`${dates.length} days | ${total} commits`)
+
+  const ok = await confirm({
+    message: `Create ${total} commits and force-push to ${repoUrl}?`,
+    default: true,
+  })
+  if (!ok) { console.log('Aborted.'); process.exit(0) }
+
+  console.log('\nInitialising repo...')
+  initRepo(repoDir)
+  setRemote(repoDir, repoUrl)
+
+  console.log('Creating commits (this takes ~20–30 min)...\n')
+  let done = 0
+  for (let i = 0; i < dates.length; i++) {
+    const d = dates[i]
+    const n = schedule.get(d)
+    for (let h = 0; h < n; h++) {
+      makeCommit(repoDir, d, 8 + (h % 10), Math.floor(h / 10))
+      done++
+    }
+    if (i % 50 === 0 || i === dates.length - 1) {
+      const pct = ((i + 1) / dates.length * 100).toFixed(1)
+      process.stdout.write(`\r  ${pct.padStart(5)}%  day ${String(i + 1).padStart(4)}/${dates.length}  commits ${String(done).padStart(6)}/${total}`)
+    }
+  }
+
+  console.log('\n\nPushing to GitHub...')
+  push(repoDir)
+  console.log('\nDone! Your contribution graph will update in a few minutes.')
+  console.log(`\nMake sure ${identity.email} is verified on your GitHub account:`)
+  console.log('  github.com/settings/emails')
+}
+
+main().catch(err => {
+  console.error('\nError:', err.message)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "github-contribution-art",
+  "version": "1.0.0",
+  "description": "Fill your GitHub contribution graph with pixel art year numbers",
+  "type": "module",
+  "bin": {
+    "github-contribution-art": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "dependencies": {
+    "@inquirer/prompts": "^7.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "github",
+    "contributions",
+    "pixel-art",
+    "cli",
+    "git"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RadosavAntonio/github-contribution-art.git"
+  },
+  "homepage": "https://github.com/RadosavAntonio/github-contribution-art#readme"
+}

package/src/art.js

@@ -0,0 +1,84 @@
+const DIGITS = {
+  '0': ['01110','10001','10001','10001','10001','10001','01110'],
+  '1': ['00100','01100','00100','00100','00100','00100','01110'],
+  '2': ['01110','10001','00001','00110','01000','10000','11111'],
+  '3': ['11110','00001','00001','01110','00001','00001','11110'],
+  '4': ['10001','10001','10001','11111','00001','00001','00001'],
+  '5': ['11111','10000','10000','11110','00001','00001','11110'],
+  '6': ['01111','10000','10000','11110','10001','10001','01110'],
+  '7': ['11111','00001','00010','00100','01000','01000','01000'],
+  '8': ['01110','10001','10001','01110','10001','10001','01110'],
+  '9': ['01110','10001','10001','01111','00001','00010','01100'],
+}
+
+const LIGHT = 3
+const DARK = 15
+
+function addDays(date, n) {
+  const d = new Date(date)
+  d.setUTCDate(d.getUTCDate() + n)
+  return d
+}
+
+function dateStr(d) {
+  return d.toISOString().slice(0, 10)
+}
+
+function pixelColumns(text) {
+  const cols = []
+  for (let i = 0; i < text.length; i++) {
+    if (i > 0) cols.push(new Array(7).fill(0))
+    const rows = DIGITS[text[i]]
+    for (let c = 0; c < 5; c++) {
+      cols.push(Array.from({ length: 7 }, (_, r) => parseInt(rows[r][c])))
+    }
+  }
+  return cols
+}
+
+function yearArtDates(year) {
+  const pcols = pixelColumns(String(year))
+  const startCol = Math.floor((52 - pcols.length) / 2)
+
+  const jan1 = new Date(Date.UTC(year, 0, 1))
+  const firstSunday = addDays(jan1, -jan1.getUTCDay())
+
+  const art = new Map()
+  for (let ci = 0; ci < pcols.length; ci++) {
+    const vc = startCol + ci
+    for (let row = 0; row < 7; row++) {
+      if (!pcols[ci][row]) continue
+      const d = addDays(firstSunday, vc * 7 + row)
+      if (d.getUTCFullYear() === year) {
+        art.set(dateStr(d), DARK)
+      }
+    }
+  }
+  return art
+}
+
+export function buildSchedule(years) {
+  const schedule = new Map()
+
+  for (const year of years) {
+    for (const [d, count] of yearArtDates(year)) {
+      schedule.set(d, count)
+    }
+  }
+
+  const today = dateStr(new Date())
+  const currentYear = new Date().getUTCFullYear()
+
+  // Fill background only for selected years
+  for (const year of years) {
+    const endStr = year === currentYear ? today : `${year}-12-31`
+    let d = new Date(Date.UTC(year, 0, 1))
+    while (dateStr(d) <= endStr) {
+      const key = dateStr(d)
+      if (!schedule.has(key)) schedule.set(key, LIGHT)
+      d = addDays(d, 1)
+    }
+  }
+
+  return schedule
+}

package/src/git.js

@@ -0,0 +1,43 @@
+import { execSync } from 'child_process'
+import { existsSync, mkdirSync, rmSync } from 'fs'
+import { join } from 'path'
+
+function run(cmd, opts = {}) {
+  execSync(cmd, { stdio: 'pipe', ...opts })
+}
+
+export function checkIdentity() {
+  try {
+    const email = execSync('git config user.email', { stdio: 'pipe' }).toString().trim()
+    const name = execSync('git config user.name', { stdio: 'pipe' }).toString().trim()
+    if (!email || !name) throw new Error('missing')
+    return { email, name }
+  } catch {
+    console.error('\nGit identity not set. Run:\n  git config --global user.email "you@example.com"\n  git config --global user.name "Your Name"')
+    process.exit(1)
+  }
+}
+
+export function initRepo(dir) {
+  mkdirSync(dir, { recursive: true })
+  // always start fresh — local repo is disposable, remote gets force-pushed
+  if (existsSync(join(dir, '.git'))) {
+    rmSync(join(dir, '.git'), { recursive: true, force: true })
+  }
+  run('git init -b main', { cwd: dir })
+}
+
+export function makeCommit(dir, date, hour, minute) {
+  const ts = `${date}T${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}:00`
+  const env = { ...process.env, GIT_AUTHOR_DATE: ts, GIT_COMMITTER_DATE: ts }
+  execSync('git commit --allow-empty -m "update"', { cwd: dir, env, stdio: 'pipe' })
+}
+
+export function setRemote(dir, url) {
+  try { run('git remote remove origin', { cwd: dir }) } catch {}
+  run(`git remote add origin ${url}`, { cwd: dir })
+}
+
+export function push(dir) {
+  execSync('git push -u origin main --force', { cwd: dir, stdio: 'inherit' })
+}