# 🌿 Gitwig — Terminal Git UI & SourceTree Alternative (Built in Rust)
<p align="center">
<img src="resources/icon.png" width="180" height="180" alt="Gitwig Terminal Git UI Logo" />
</p>
**Gitwig** (derived from **Git** + **Twig**, representing repository branches) is a lightweight, keyboard-driven **Terminal Git UI** (TUI) designed as a fast, minimal alternative to desktop Git GUI clients like **SourceTree** and terminal clients like **lazygit**. Built with Rust and `ratatui`, Gitwig presents all your Git repositories, worktrees, stashes, and branches in a clean, interactive bordered layout directly inside your terminal window.
---
## 📸 Preview
*To play the interactive terminal recording locally:*
```sh
asciinema play resources/preview.cast
```
---
## 📖 Documentation
Explore the features, configuration, and controls of Gitwig:
- [🚀 Installation & Running](docs/installation.md)
- [✨ Features](docs/features.md)
- [⌨️ Keybindings](docs/keybindings.md)
- [📂 Item Status Indicators](docs/status_indicators.md)
- [🔍 Detail View](docs/detail_view.md)
- [🖥️ Panels & UI Windows](docs/panels.md)
- [🔧 Configuration](docs/configuration.md)
- [🎨 Font & Symbol Support](docs/font_support.md)
---
## 🤝 QA & Special Thanks
A huge thank you to the following friends who helped with Quality Assurance (QA) and testing to make Gitwig more robust:
- **Ehsanul Alam Sabbir** — [GitHub](https://github.com/easabbir) / [LinkedIn](https://www.linkedin.com/in/ehsanul-alam-sabbir/)
- **Fahim Rahman** — [GitHub](https://github.com/fahim-6/) / [LinkedIn](https://www.linkedin.com/in/fahim-rahman-4b333791/)