GitHub Action · zero dependencies · MIT

Your contribution graph,
but alive.

One workflow file turns your last year of commits into an animated SVG for your profile README. It re-renders every night, in light and dark.

octocat / README.md

Playground

Make yours

Load your own graph, pick an effect, and the setup below updates to match.

README.md
Animated contribution graph preview
Effecttheme
Palettepalette
Modemode
1×
Captionlabel

Setup · about two minutes

Put it on your profile

Everything happens in your profile repository, <your-username>/<your-username>, the one whose README shows on your GitHub page.

  1. Add the workflow

    Create .github/workflows/contribution-fx.yml with this content. The two outputs lines follow your playground choices.

    contribution-fx.yml
  2. Run it once

    Open the Actions tab, choose contribution-fx and press Run workflow. It publishes the SVGs to an output branch, then refreshes them every day at midnight UTC.

  3. Paste into README.md

    The <picture> tag shows the dark version to visitors who use GitHub in dark mode.

    README.md

Made your profile move?

A star helps other people find contribution-fx, and tells us which effect to build next.

Star Sur1ive/contribution-fx