# Gitwig — Terminal Git UI & SourceTree Alternative (Built in Rust)

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="resources/logo-dark.svg">
    <img src="resources/logo-light.svg" width="480" alt="Gitwig Terminal Git UI Logo" />
  </picture>
</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.

🌐 **Website & Documentation:** [gitwig.dev](https://gitwig.dev)

---

## 📸 Preview

![Gitwig Demo](resources/preview.gif)

*To play the interactive terminal recording locally:*
```sh
asciinema play resources/preview.cast
```

---

## 📖 Documentation

The complete documentation is available online at **[gitwig.dev/docs](https://gitwig.dev/docs)**.

You can also explore the raw markdown files below:

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/)