A solarpunk garden for your GitHub profile, generated daily from your contributions

Description and use

Transform a GitHub contribution graph into a daily‑updated isometric garden SVG that visualizes activity, seasons, and climate, and embed it in a profile README.

Problem

Convert a GitHub contribution graph into a daily‑updated isometric garden SVG that reflects activity levels, seasons, and climate, and embed it in a profile README.

Outcome

The garden updates daily, visualizing contributions with plants that scale with activity, seasons that match the chosen climate, and a gardener that walks the current day’s tile. It supports light/dark themes and a mobile‑optimized view, and can be embedded in a README via a <picture> element.

Workflow

• Fork or copy the garden‑graph repository into your own profile repo.
• Enable GitHub Actions.
• Edit .github/workflows/garden.yml to set GARDEN_CLIMATE, GARDEN_LANG, and optionally GITHUB_LOGIN, GITHUB_TOKEN, GARDEN_YEARS.
• Run the "Update garden" workflow once from the Actions tab.
• Add the generated SVGs to your README using a <picture> element with media queries for light/dark and mobile.
• Commit the changes. The workflow will run daily at 05:17 UTC and commit only when files change.

Evidence

I turned my GitHub contribution graph into an isometric garden. One tile per day, a plant that grows with the number of contributions, seasons that follow the calendar, and a small gardener walking around today's tile.

Source

The workflow commits only if the files changed. That makes one commit per day, and a run takes about 15 seconds.

Source

To also count your private contributions, add a secret GH_STATS_TOKEN (a token with read:user) and enable "Private contributions" in your profile settings.

Source

Embed the year view in your profile README with <picture>, which serves a light and a dark image.

Source