Home

🍄 Welcome to the Mario GitHub Contribution Graph!

Welcome to the official Wiki for the Mario-GitHub-Contribution-Graph project.

This project was born out of a desire to make the standard, static GitHub contribution grid significantly more dynamic, interactive, and nostalgic. By leveraging Python, GitHub Actions, and pure SVG animation, this project turns a developer's real commit history into a playable-looking game level.

🌟 Core Features

Feature	Description
Dynamic Parkour Pathing	Mario dynamically calculates his jumps. If you code consistently, he runs across the top of the blocks. If you take a break, he drops to the ground.
Interactive Coins	Reaching a "Level 4" contribution day spawns a spinning coin. The SVG calculates the exact millisecond Mario touches it to trigger a collection animation!
100% Pure SVG	No .png, .jpg, or external assets are used. Mario, the clouds, and the coins are drawn using pure SVG <rect> math, entirely bypassing GitHub's strict image security (Camo).
Automated Updates	Runs fully headless on GitHub Actions, updating your profile every night at midnight.

📚 Table of Contents

• How It Works - Understand the math and architecture behind the generation.
• Installation Guide - Step-by-step setup instructions (links to README).
• Customization Guide - Learn how to change the colors, speeds, and characters.
• Roadmap & Contributing - See what is planned next for the project.