git-battle

This will basically turns your GitHub profile into an RPG character, using your actual stats, like repos and stars to let you fight your friends and see who’s the better dev.

Comment

Git Battle

A turn-based RPG where your GitHub stats determine your power.

Git Battle takes two GitHub usernames, analyzes their profiles (Repositories, Followers, Activity), and generates a unique RPG character class and stats. Battle your friends or famous developers in a retro 8-bit arena!

Git Battle Screenshot

Features

  • Real-Time Data: Fetches live data from the GitHub API.
  • Class System: Your coding habits determine your RPG Class:
    • Frontend Warrior: High Speed. Special: Pixel Slash (Double Hit).
    • Backend Mage: High Attack. Special: DDoS Blast (Massive Dmg + Recoil).
    • DevOps Paladin: High Defense. Special: Container Shield (Damage + Heal).
  • Strategic Combat:
    • Speed Mechanic: Faster characters attack first and crit more often.
    • Cooldown Management: Tactical use of Heals and Special Abilities.
    • Smart AI: Opponent AI reacts to low health and cooldowns.
  • Retro Aesthetic: Custom pixel fonts, CSS animations, and 8-bit UI design.

How It Works

The game engine calculates stats based on your GitHub profile:

  • HP: Base + Repos + Followers
  • Attack: Scaled by Repository count.
  • Defense: Scaled by Follower count.
  • Speed: Scaled by Repository count (Frontend Warriors get a speed buff).
  • Variance: A slight random multiplier ensures no two battles are exactly the same.

Tech Stack

Getting Started

To run locally, follow these steps:

  1. Clone the repository:

    git clone [https://github.com/mrsiuuuu-x1/git-battle.git](https://github.com/mrsiuuuu-x1/git-battle.git)
cd git-battle

  2. Install dependencies:

    npm install
# or
yarn install

  3. Run the development server:

    npm run dev

  4. Open your browser: Navigate to http://localhost:3000

Roadmap (Coming Soon)

  • [ ] Daily Challenges: Face off against a "Boss of the Day" (e.g., Linus Torvalds or Dan Abramov) with boosted stats.
  • [ ] Inventory & Loot: Earn "Commit Shards" to buy cosmetic skins or temporary stat buffs.
  • [ ] Guilds (Organizations): Group players by GitHub Organizations to compete for team-based rankings.
  • [ ] Replay System: Share a unique URL so others can watch a play-by-play of your best battles.

Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

Share this project:

Updates