README-ready farms

Turn GitHub activity into a living SVG badge.

Drop gitstead into your repository and every push, review, and issue will repaint the pixels. No dashboards, just a cozy farm that stays in sync with your work.

See badge examples Install gitstead

Live stead badge

octocat/hello-world

This SVG is generated by gitstead—no mockups, just the default stead you get when the app is installed.

Real SVG output

See steads growing in the wild

These previews are rendered with the same SVG engine gitstead uses in production, so you can see how the artwork and stats evolve from level to level.

Level 1 · Freshly tilled

Level 1

Brand-new install showing the starter field and default stats you get out of the box.

Level 2 · Dawn patrol

Level 2

A stead with a few commits under its belt—note the evolving sky and boosted harvest meter.

Level 3 · Busy harvest

Level 3

Keep the work flowing and the stead lights up with new sprites, animated border, and higher ranks.

Quick-start chores

Get your stead sprouting in minutes

Light up your README with a living pixel tableau. Follow these steps to install the GitHub App and embed the badge with retro farm charm.

1
Install the GitHub App
Authorize gitstead for the repos you want to cultivate—events start syncing the moment you give the nod.
Open the GitHub App
2
Add the README badge
Drop the live SVG in your README to let contributors tour the farm right inside the repo.
```
![gitstead](https://gitstead.com/api/your-org/your-repo/badge.svg?theme=auto)
```

Why maintainers love gitstead

Designed for teams who want to celebrate contribution streaks without another dashboard—just a living patch of pixel soil.

Living pixel parcels

Every commit, issue, and review animates a new tile on your stead so the farm looks livelier with each contribution.

Webhook-powered weather

GitHub webhooks trigger seasonal swaps instantly—watch the sky change color as your team keeps the crops humming.

Redis cellar storage

Upstash Redis keeps your acreage state safely packed away, ready to restore no matter how many harvests you run.

Badge + leaderboard APIs

Fetch the live stead SVG and leaderboard snapshots with a single request to power README badges and overlays.

Ready to plant your repository stead?

Install the GitHub App, drop the badge in your README, and let gitstead celebrate the work your team ships—no custom deploys or dashboards required.

Install the GitHub App Review install steps