GitLeaf
A small service that turns your GitHub contributions into a watercolor plant. Every day of the year is a leaf, and the more you did that day, the deeper its green. Paste one image line into your profile README and the picture keeps itself up to date.
- Type
- Image service for GitHub READMEs
- Period
- Oct 2026
- Runs on
- Cloudflare Workers + D1 + R2
About
A contribution graph is a grid of green squares. I wanted something I'd enjoy looking at, so GitLeaf paints the year as a plant: a small leaf for each day, shaded by how much happened, and a bigger leaf at the end of each branch for the week. Days that haven't come yet are faint outlines, and the plant's caption counts the year's contributions.
It's made to sit in a profile README. You paste one image line with your username, with no sign-up and no GitHub Actions. The first time the image is requested, the service reads your contributions, paints the plant and saves it. After that it's repainted once a day under the same URL, so your README never changes and nothing is committed.
The leaves are eight watercolor leaf shapes in five shades, made with an AI image tool. The code lays them out on four stems and fills in one per day. The whole picture is a single SVG file, so it works as a plain image in a README, where scripts and outside requests are blocked.
What it does
- One leaf a day
- The shade follows GitHub's own contribution level, from a faint outline on quiet days to deep green. Weeks get a larger leaf with the week's average.
- One line to use
- Add the image line with your username to your README. No account, and the picture shows up on the first request.
- Repainted every day
- The same URL shows the latest activity, so the README never needs editing. A new year starts a new plant; ?year= pins any year back to 2008.
- A little breeze
- Add ?motion=breeze and the branches sway slowly, each at its own pace. It's CSS only, and it stops if the device asks for less motion.
How it's built
- Service
- TypeScript · Cloudflare Workers with Cron Triggers
- Storage
- R2 for the saved SVGs · D1 for gardens and refresh times
- Picture
- SVG written in plain JavaScript · eight watercolor leaf images in five shades (sharp) · CSS animation for the breeze
- Data
- GitHub GraphQL API, token kept as a Worker secret
- Quality
- Tests on the real Workers runtime with D1 and R2 (Miniflare) · a live check against GitHub · GitHub Actions
Counts are GitHub contributions, not only commits. Private activity only shows if the service's GitHub token can see it. The pictures use my own account.