Skip to content

GitWorld Engine

Actions

About

Generate an animated SVG city from your GitHub contribution graph
v1.0.0
Latest
Star (2)

🌍 GitWorld Engine

A GitHub Action that turns your contribution graph into an animated city — visible right on your GitHub profile.

Like the snake game, but instead of a snake eating your contributions, your commits build a living, breathing world.

GitWorld Preview


How it Works

A GitHub Action runs daily, fetches your public GitHub data, and generates an animated SVG that lives in your profile README.

The World Mapping

GitHub World
🏙️ Repo City
🏗️ Commit Building (height = commit count)
⭐ Stars Tempo (animation speed)
🐛 Issue Monster (roams the streets)
🔀 Pull Request Boss (crown on building)
💻 Language Biome & color theme
🏢 Organization Kingdom border
👥 Followers Road density
🔥 Streak Smoke / fire effects

Biome Themes (auto-selected by top language)

Language Biome
JavaScript Golden City Kingdom
TypeScript Indigo Empire
Python Emerald Forest
Go Teal Ocean Realm
Rust Red Wasteland

Setup (2 steps)

Step 1 — Add the workflow to your profile repo

Copy profile-workflow.yml to:

Dasmat13/Dasmat13/.github/workflows/gitworld.yml

Step 2 — Add the SVG to your profile README

![GitWorld](https://raw.githubusercontent.com/Dasmat13/Dasmat13/main/dist/gitworld.svg)

That's it. The action runs daily and keeps your world updated.


For Others to Use

- uses: Dasmat13/git-world-action@main
  with:
    github_user_name: ${{ github.actor }}
    github_token: ${{ secrets.GITHUB_TOKEN }}
    svg_out_path: dist/gitworld.svg

Local Development

git clone https://github.com/Dasmat13/git-world-action.git
cd git-world-action
npm install
npm run build        # compiles src/ → dist/index.js

Inspiration

Inspired by Platane/snk (the snake game) — but instead of eating contributions, your commits build a world.


License

MIT © Dasmat13

GitWorld Engine is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Generate an animated SVG city from your GitHub contribution graph
v1.0.0
Latest

GitWorld Engine is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.