Turn Your GitHub Contribution Graph Into an ASCII City

Description and use

Generate a dynamic SVG skyline from your GitHub contribution graph, updated nightly via GitHub Actions.

Problem

Represent GitHub contribution activity in a more engaging visual form for personal branding on GitHub profiles.

Outcome

The workflow produces a dynamic, themed skyline SVG that updates nightly, enhancing the visual appeal of a GitHub profile README without manual intervention.

Workflow

• Install Skyline CLI via go install github.com/pinkpixel-dev/skyline@latest
• Create a GitHub Actions workflow file .github/workflows/skyline.yml in the profile repo
• Configure the workflow to run nightly and on demand, using go run github.com/pinkpixel-dev/skyline@latest -theme neon -svg skyline.svg "${{ github.repository_owner }}"
• Publish the generated skyline.svg to a dedicated output branch using a temporary git repository
• Add an image link to the README pointing to the SVG in the output branch

Evidence

I made Skyline, a small Go CLI that takes your GitHub contribution history and turns it into an ASCII city.

Source

Skyline needs access to the GitHub API, but it tries to make authentication fairly painless.

Source

You can have GitHub Actions regenerate your city automatically every night so your skyline changes along with your contribution graph.

Source