Skip to content

A visually exciting Git management extension for Visual Studio 2022/2026, bringing GitLens-style functionality with theme-adaptive vibrant colors.

License

Notifications You must be signed in to change notification settings

CodingWithCalvin/VS-GitRanger

Repository files navigation

Git Ranger Logo

Git Ranger

Visual Studio 2022 .NET Framework License: MIT


A visually stunning Git management extension for Visual Studio 2022/2026, with theme-adaptive vibrant colors. 🎨✨


🚀 Features

🔍 Inline Blame Annotations

See who changed each line directly in the editor — author name, commit date, and message displayed right at the end of each line!

  • 🎨 Color-coded by author — each contributor gets a unique vibrant color
  • 🔥 Heat map mode — green = recent, red = old (optional)
  • 👁️ Configurable opacity and display format
  • 💬 Hover for full commit details

📊 Blame Gutter Margin

A visual indicator in the editor margin showing commit history at a glance.

  • 📈 Age bars showing relative commit age
  • 🎯 Author color indicators
  • 📋 Click to copy commit SHA
  • 🔎 Hover for commit details

🔮 What's Next?

Check out our issues list to see what features are planned and vote on what you'd like to see next!


📦 Installation

From Visual Studio Marketplace

VS Marketplace

From Source

# 1. Clone the repository
git clone https://github.com/CodingWithCalvin/VS-GitRanger.git

# 2. Open in Visual Studio 2022
# 3. Build the solution (F5 to debug)
# 4. VSIX will be created in the output directory

⚙️ Configuration

Configure Git Ranger via Tools → Options → Git Ranger

🏷️ Blame Settings

Setting Description Default
Enable Inline Blame Show blame at end of lines true
Enable Blame Gutter Show blame in margin true
Show Author Name Display author in inline blame true
Show Commit Date Display date in inline blame true
Show Commit Message Display message in inline blame true
Date Format relative or custom format string relative

🎨 Color Settings

Setting Description Default
Color Mode Author, Age, or None Author
Max Age (days) Maximum age for heat map 365

🖥️ Display Settings

Setting Description Default
Inline Blame Opacity Transparency (0.0 - 1.0) 0.7
Compact Mode Condensed display format false
Gutter Width Width in pixels 40
Show Age Bars Visual age indicators true

📋 Requirements

  • 💻 Visual Studio 2022 (17.0) or later
  • 🔧 .NET Framework 4.8

🛠️ Technology Stack

Component Technology
🔗 Git Integration LibGit2Sharp
🎨 UI Framework WPF
📊 Graph Rendering SkiaSharp (planned)
🔌 VS Integration Community.VisualStudio.Toolkit

🤝 Contributing

Contributions are welcome! Feel free to submit issues and pull requests. 💪

  1. 🍴 Fork the repository
  2. 🌿 Create a feature branch (git checkout -b feature/amazing-feature)
  3. 💾 Commit your changes (git commit -m 'feat: add amazing feature')
  4. 📤 Push to the branch (git push origin feature/amazing-feature)
  5. 🎉 Open a Pull Request

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.


👥 Contributors

CalvinAllen


⭐ If you find Git Ranger useful, please consider giving it a star! ⭐

Made with ❤️ for the Visual Studio community from Coding With Calvin

About

A visually exciting Git management extension for Visual Studio 2022/2026, bringing GitLens-style functionality with theme-adaptive vibrant colors.

Resources

License

Stars

Watchers

Forks

Languages