DEV Community

dasmat
dasmat

Posted on

I Built GitWorld Engine: A GitHub Action That Turns Your Contributions into an Animated City

#typescript #github #opensource #showdev

I Built GitWorld Engine: A GitHub Action That Turns Your Contributions into an Animated City

GitHub profiles have become more than just a list of repositories—they're a way to showcase your work and personality.

Many developers use the classic GitHub Snake animation to visualize their contribution graph. While I like that idea, I wondered:

What if your contributions built something instead of being eaten?

That question led me to build GitWorld Engine.

🌍 What is GitWorld Engine?

GitWorld Engine is an open-source GitHub Action that transforms your GitHub contribution graph into a living, animated pixel-art world for your profile README.

Instead of displaying a static graph, your GitHub activity becomes part of an evolving world.

  • 🏙️ Repositories become cities
  • 🏗️ Commits grow buildings
  • 👑 Pull requests become bosses
  • 🐛 Issues become roaming monsters
  • 🌳 Your primary programming language determines the world's biome

Every time your GitHub activity changes, the world evolves automatically.

⚙️ How It Works

The GitHub Action runs on a schedule, collects your public GitHub activity, generates an animated SVG, and updates it in your profile repository.

Setup only takes a few minutes.

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

Then add the generated SVG to your GitHub profile README.

💡 Why I Built It

I wanted to create something that felt more interactive and playful than a traditional contribution graph.

Instead of simply visualizing commits, GitWorld Engine turns your coding activity into a tiny world that grows as you continue building projects.

🚀 What's Next?

I'm planning to add more features, including:

  • 🌙 Day and night cycles
  • 🌧️ Weather effects
  • 🚗 Moving vehicles
  • 🚂 Trains
  • 🏰 Additional biome themes
  • 🎮 More pixel-art animations

Community feedback will help shape future updates.

🔗 Try It

If you have ideas, suggestions, or feature requests, I'd love to hear them. Contributions are always welcome!

Top comments (0)