Gitree/README.md

Gitree

A native Dear ImGui Git client built with libgit2 and GLFW.

Build on Windows

Clone with submodules, then run run.bat. The script configures a Release build, builds Gitree and launches it. You can pass a repository path to open it directly:

run.bat C:\path\to\repository

Manual build:

git submodule update --init --recursive
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel

Vendored dependencies are pinned under vendor/ and compiled as static libraries:

• libgit2 1.9.4
• Dear ImGui 1.92.8 (docking branch)
• GLFW 3.4
• iZo 0.1.0

The bundled Inter variable font is licensed under the SIL Open Font License. Font Awesome Free icons are bundled from Attascii and merged into the ImGui font atlas.

User settings, ImGui layout state, and recently closed repository history are stored in %APPDATA%\Identity\Gitree on Windows. The directory is created automatically. Commit avatars are resolved from normalized author emails through Gravatar and cached in the avatars subdirectory; an identicon is used when an account has no custom image.

Source layout

• src/managers/ owns Git, window, user-data, and avatar services.
• src/models/ contains repository and commit data models.
• src/ui/ contains the Dear ImGui application interface.
• src/main.cpp is the minimal process entry point.