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
sindresorhus	API	same	Open
yyx990803	API	same	Open
gaearon	API	same	Open
isaacs	API	same	Open
antirez	API	same	Open
gvanrossum	API	same	Open

Adding a legend

No repo file. Append one row to the matrix in github-legends.yml — only id and user:

- id: 07-octocat        # numbered ?id= deep link; prefix matches ?d=7 in matrix order
  user: octocat         # chart title and API path

id must stay numbered (00-, 01-, …) in matrix order. The workflow step already wires curl, --json-path, --select, date grouping, and 3D bar flags.

Optionally add a row to this page’s table.

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

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

GitHub Legends

Adding a legend

Related guides