GitHub Legends

GitHub Legends turns public contribution calendars into 3D bar skylines. CI fetches each user from the jogruber GitHub contributions API — no static repo files. Demonstrates --json-path, --select, and date axis splitting. Parser: JSON.

Live dashboard: vizb.goptics.org/examples/live/github-legends/

The workflow github-legends.yml runs on every release and on a Friday schedule (0 12 * * 5 UTC) so skylines stay current.

Chart	Source	Pattern	Dashboard
torvalds	API	[z{Year}-y{Month}-x{Date}]	Open
ahmadawais	API	same	Open
antirez	API	same	Open
gvanrossum	API	same	Open
sindresorhus	API	same	Open
yyx990803	API	same	Open
gaearon	API	same	Open
isaacs	API	same	Open

Adding a legend

No repo file. Append one row to the matrix in github-legends.yml with serial, id, and description:

- serial: "08"          # controls merge and dashboard order
  id: octocat           # stable ID, chart title, API path, and ?id= deep link
  description: "The Octocat, GitHub's mascot"

serial must stay numbered ("00", "01", …) in matrix order. Changing the order does not change the stable id or its deep link. The workflow step already wires curl, --json-path, --select, date grouping, and 3D bar flags.

Optionally add a row to this page’s table.

Related guides

• Tabular data — JSON path and select
• Group — date bracket patterns
• 3D Charts — bar3D skylines

Tip

Same pipeline locally (needs network):

curl -sfL "https://github-contributions-api.jogruber.de/v4/torvalds" \
  | vizb bar - \
      --json-path '.contributions' \
      --select 'count{Contributions}' \
      -g date -p '[z{Year}-y{Month}-x{Date}]' \
      -o torvalds.html