GitHub Contribution Gravity Lens

日本語 | English

Your contributions bend spacetime.

🚀 Add It To Your Profile

1. Create .github/workflows/gravity-lens.yml

name: generate gravity-lens

on:
  schedule:
    - cron: "0 0 * * *"
  workflow_dispatch:
  push:
    branches: [main]

permissions:
  contents: write

concurrency:
  group: gravity-lens
  cancel-in-progress: true

jobs:
  generate:
    runs-on: ubuntu-latest
    timeout-minutes: 10

    steps:
      - uses: actions/checkout@v4

      - name: Generate (dark + light)
        uses: Rujuu-prog/[email protected]
        with:
          github-token: ${{ github.token }}
          theme: github
          output-path: dist/gravity-lens-dark.svg

      - name: Generate light theme
        uses: Rujuu-prog/[email protected]
        with:
          github-token: ${{ github.token }}
          theme: paper-light
          output-path: dist/gravity-lens.svg

      - name: Deploy to output branch
        uses: crazy-max/[email protected]
        with:
          target_branch: output
          build_dir: dist
        env:
          GITHUB_TOKEN: ${{ github.token }}

No PAT required — github.token is provided automatically by GitHub Actions.

| Input | Required | Default | Description | |-------|----------|---------|-------------| | github-token | Yes | — | GitHub token for API access | | username | No | Repository owner | GitHub username | | theme | No | github | Theme name | | format | No | svg | Output format (svg or gif) | | output-path | No | gravity-lens.{format} | Output file path | | strength | No | 0.35 | Warp strength (0-1) |

2. Embed in your README

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/<USER>/<REPO>/output/gravity-lens-dark.svg">
  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/<USER>/<REPO>/output/gravity-lens.svg">
  <img alt="GitHub Contribution Gravity Lens" src="https://raw.githubusercontent.com/<USER>/<REPO>/output/gravity-lens.svg">
</picture>

Replace <USER>/<REPO> with your GitHub username and repository name.

3. Run

Go to the Actions tab and trigger the workflow. That's it.

✨ What Makes It Different?

• 🌌 Physics-based animation — Cells warp toward anomalies like light bending around a massive object
• 🌊 Left-to-right wave — Activation ripples across the grid with staggered timing per anomaly
• 🔮 Interference patterns — Overlapping gravity wells create visible pulse effects
• 🎨 6 themed worlds — Each theme has its own warp intensity, dimming, and glow parameters

Not just colors. Different physics.

🎨 Themes

| Theme | Description | |-------|-------------| | github | Classic dark green. The default. | | deep-space | Deep blue cosmos. Stronger warp, brighter peaks. | | monochrome | Grayscale minimalism. | | solar-flare | Warm red-orange. Intense warp. | | event-horizon | Near-black. The grid hides until anomalies distort it. | | paper-light | Light background for GitHub light mode. |

See the Theme Gallery for previews and physics parameters.

🧠 Under the Hood

1. Fetch — Pull the last year of contributions via GitHub GraphQL API
2. Detect — Identify top activity spikes as gravitational anomalies
3. Warp — Compute per-cell displacement with a local lens model (R=60px)
4. Animate — Render a 14-second loop: rest → awakening → lens → interference → restore

📚 Documentation

• Getting Started — Setup, tokens, and workflow options
• Themes — Full gallery with physics parameters
• CLI Reference — All options and programmatic API
• Development — Local setup, testing, and architecture

If you like this project, consider giving it a ⭐

MIT License