contribution lands rev 0.2.0

Your year, drawn first, then built.

Contribution Lands is a Chrome extension that rebuilds the contribution graph on GitHub profile pages as an isometric New York City. Every day is a lot. Quiet days stay low, busy days rise into towers, and today is a building site.

Free and MIT licensed · Chrome 111 or later · On the Chrome Web Store

A-101 a real year · 1 lot = 1 day

Drawn from your contributions.

A-102 history Figure from Hairline by Lucas Marques, MIT

Each lot is one day of your contribution graph. The commits, pull requests, reviews and issues GitHub already counts for that day set its height, on one scale for everyone.

The extension reads the calendar on the profile you are viewing, and the public contributions page for earlier dates so streaks are complete. Nothing is sent anywhere else and nothing is stored but your settings. Privacy policy.

Works on any profile, yours or anyone's. The drawing above is the maker's own last 22 weeks, refreshed every night.

Every detail, by what it means.

Eight figures, shelved by where you meet them. Each one answers the pointer.

The land

3 sheets · A-201 to A-203

One scale for everyone

A-201hover a shade

A day's height comes from its count, on the same scale for everyone: 40 or more is a skyscraper whoever you are, so a steady heavy year reads as skyline.

Today is a building site

A-202stage 2 · frame

Today's lot climbs a stage each time today's shade deepens. Tomorrow it is built like any other day.

Your best days are landmarks

A-203hover the tall one

Your sixteen busiest days are built as real New York buildings, ranked from your best day down.

The sixteen, from your best day down
  1. Empire State Building
  2. Chrysler Building
  3. One World Trade Center
  4. Statue of Liberty
  5. Flatiron Building
  6. 30 Rockefeller Plaza
  7. One Vanderbilt
  8. 30 Hudson Yards and the Edge
  9. 56 Leonard Street
  10. Hearst Tower
  11. 40 Wall Street
  12. Bank of America Tower
  13. 8 Spruce Street
  14. Central Park Tower
  15. Woolworth Building
  16. The Vessel

The streets

2 sheets · A-301 to A-302

Streaks run on rails

A-3019-day streak

Your longest streak is an elevated railway along the front street, with a train running its length.

Blocks, streets and taxis

A-3023 blocks · 18 weeks

Weeks are grouped into six-week blocks with streets between them, and taxis work the grid. Motion can be switched off in the popup.

On your profile

2 sheets · A-401 to A-402

Stats in GitHub's own style

hover a statA-401

Contributions and Streaks panels sit over the land, styled like GitHub's own headings.

Click a building, see that day

A-402click a building

Clicking a lot does what clicking a square does: GitHub filters the activity below to that day.

In the toolbar

1 sheet · A-501
Contribution LandsYour contribution graph, built as a world.
World Display
Changes apply instantly to open GitHub profiles.

One popup, five settings

Lands · stats on · motion onA-501
World
NYC Skyline, the one world that ships today. More worlds later.
2D, Lands, Both
Keep GitHub's squares, swap them for the city, or show the two together.
Same scale
Heights from each day's count on one scale for everyone, or GitHub's shades relative to your own busiest days.
Stats
Show or hide the Contributions and Streaks panels.
Motion
Taxis and the train move, or the city holds still.

Light and dark follow your GitHub theme.

In your README

1 sheet · A-601
A rendered contribution land: an isometric strip of New York with brownstones, parks and towers, beside Contributions and Streaks panels. A-601 A real render from the Action, light version.

Your city, rendered every night

.webp · light and dark
  1. Add this workflow to your profile repository, the one named after your username.
  2. Run it once from the Actions tab. It then renders nightly.
  3. Show images/contribution-land-light.webp in your README, with contribution-land-dark.webp in a <picture> source for dark mode.
# .github/workflows/contribution-land.yml
name: Contribution land
on:
  schedule:
    - cron: "0 3 * * *"
  workflow_dispatch:
permissions:
  contents: write
jobs:
  render:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: jeanluciradukunda/contribution-lands@main
        with:
          theme: city-nyc
          output-dir: images
      - run: |
          git config user.name "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git add images
          git commit -m "Update contribution land" || exit 0
          git push

Full instructions in the README

Install it in one click.

3 steps · Chrome 111 or later

Contribution Lands is free on the Chrome Web Store. Prefer to build it yourself? The source and build steps are on GitHub.

  1. Add it to Chrome

    Open the Chrome Web Store listing and choose Add to Chrome.

  2. Open a profile

    Visit any GitHub profile. The graph is drawn and built as soon as the page loads.

  3. Pick a view

    Click the toolbar icon to switch between the flat graph, the land or both, and to set the scale, stats and motion.