# jetpackduba/gitnuro architecture

> Architecture diagram of the GitHub repository jetpackduba/gitnuro, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jetpackduba/gitnuro
- Repository: https://github.com/jetpackduba/gitnuro

## Overview

#### Purpose and runtime
Gitnuro is a FOSS, native multiplatform desktop Git client built with Kotlin, Jetpack Compose Desktop, and JGit—not a web application. Gradle defines a modular JVM application; the desktop entry point is `app/src/main/kotlin/com/jetpackduba/gitnuro/main.kt`, which initializes application composition in `app/src/main/kotlin/com/jetpackduba/gitnuro/App.kt`.

#### Module boundaries
The repository follows layered modules:
- **app**: Compose UI, view models, app composition, and dependency wiring.
- **domain**: Git-operation contracts, use cases, domain models, state management, and service abstractions.
- **data**: JGit-backed implementations, persistence, networking, credential handling, and in-memory repositories.
- **common**: cross-module platform/coroutine utilities.
Core boundaries are visible in `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/interfaces/`, `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/usecases/`, and `data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/`.

#### Application, tabs, and DI scopes
The app supports multiple repository tabs. Global and per-tab object graphs are separated through DI components: `app/src/main/kotlin/com/jetpackduba/gitnuro/di/AppComponent.kt`, `app/src/main/kotlin/com/jetpackduba/gitnuro/di/TabComponent.kt`, and `app/src/main/kotlin/com/jetpackduba/gitnuro/TabViewModel.kt`. A tab owns repository state and coroutine lifetime, isolating concurrent repository operations; `common/src/main/kotlin/com/jetpackduba/gitnuro/common/TabScope.kt` and `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/TabCoroutineScope.kt` support that lifecycle.

#### UI state and interaction flow
Compose screens render state from app/repository view models and invoke domain use cases rather than data implementations directly. The top-level UI/tab composition resides in `app/src/main/kotlin/com/jetpackduba/gitnuro/ui/AppTab.kt` and `app/src/main/kotlin/com/jetpackduba/gitnuro/ui/AppViewModel.kt`; open-repository orchestration is concentrated in `app/src/main/kotlin/com/jetpackduba/gitnuro/repositoryopen/RepositoryOpenViewModel.kt`. Status, history/log, commit, diff, rebase, and dialogs are presentation stages that translate user actions into operations and surface loading/errors/notifications.

#### Domain orchestration and repository state
Domain use cases coordinate validation, action sequencing, refreshes, and error boundaries. Representative flows include repository open/refresh (`domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/usecases/OpenRepositoryUseCase.kt`, `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/usecases/RefreshDataUseCase.kt`), workspace commit/staging (`domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/usecases/DoCommitUseCase.kt`), and history generation (`domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/usecases/GetLogUseCase.kt`). Shared state is modeled through repository contracts and domain models, notably `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/repositories/RepositoryStateRepository.kt` and `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/models/RepositoryState.kt`.

#### Git engine, filesystem, and refresh loop
The data layer executes Git operations through JGit and maps JGit objects into domain models. `data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/JGit.kt` is the integration anchor; concrete action families cover workspace status/staging, graph/log traversal, branches, remotes, rebase, stashes, tags, and submodules. File-system changes are monitored by `data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/FileChangesWatcher.kt`; watcher events feed the domain refresh path so the UI reflects external Git or working-tree changes.

#### Remote services, credentials, and LFS
Network Git operations use JGit transport plus HTTP/SSH credentials and optional external Git Credential Manager integration. Key boundaries are `data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/credentials/HttpCredentialsProvider.kt`, `data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/credentials/SshCredentialsProvider.kt`, and `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/credentials/external/IGitCredentialsManagerProvider.kt`. Git LFS is a separate network pipeline for authentication and object upload/download, represented by `data/src/main/kotlin/com/jetpackduba/gitnuro/data/repositories/NetworkLfsRepository.kt` and `data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/lfs/`.

#### Persistence and native/platform integration
Application settings are persisted behind the domain settings contract in `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/repositories/AppSettingsRepository.kt`, implemented via `data/src/main/kotlin/com/jetpackduba/gitnuro/data/UserSettingsDataStore.kt`. Platform integrations cover file picking, browser/file opening, shell terminals, proxies, and OS-specific credential-manager execution. Rust/UniFFI material under `rs/src/lib.rs` and `rs/uniffi.toml`, plus native-image metadata at `app/src/main/resources/META-INF/native-image/gitnuro/reachability-metadata.json`, indicate native interop/packaging support alongside the JVM desktop runtime.

Main entry points: [`app/src/main/kotlin/com/jetpackduba/gitnuro/App.kt`](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/App.kt) (Application composition), [`app/src/main/kotlin/com/jetpackduba/gitnuro/TabViewModel.kt`](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/TabViewModel.kt) (Repository tab state), [`app/src/main/kotlin/com/jetpackduba/gitnuro/di/TabComponent.kt`](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/di/TabComponent.kt) (Tab DI scope), [`data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/JGit.kt`](https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/JGit.kt) (JGit Git engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_entry(("Desktop entry point<br/>Kotlin main<br/>[main.kt]"))
  node_composition["Application composition<br/>Compose root<br/>[App.kt]"]
  node_app_di["App DI scope<br/>DI component<br/>[AppComponent.kt]"]
  node_tab_di["Tab DI scope<br/>DI component<br/>[TabComponent.kt]"]
  node_tab_vm["Repository tab state<br/>tab view model<br/>[TabViewModel.kt]"]
  node_ui["Tab UI and screens<br/>Compose presentation<br/>[AppTab.kt]"]
  node_open_vm["Open repository flow<br/>view model"]
end

subgraph group_domain["Domain layer"]
  node_contracts["Git service contracts<br/>domain interfaces"]
  node_usecases["Git operation use cases<br/>domain orchestration"]
  node_repository_state[("Repository state<br/>state repository")]
  node_tab_scope["Tab coroutine lifetime<br/>coroutine scope"]
  node_settings_contract["Settings contract<br/>domain repository"]
end

subgraph group_data["Data and integrations"]
  node_jgit{{"JGit Git engine<br/>Git integration<br/>[JGit.kt]"}}
  node_watcher["Working-tree watcher<br/>filesystem monitor"]
  node_credentials["HTTP and SSH credentials<br/>transport credentials"]
  node_lfs["Git LFS pipeline<br/>network repository"]
  node_settings_store[("User settings store<br/>persistent datastore")]
  node_native{{"Native interop and packaging<br/>Rust/UniFFI support<br/>[lib.rs]"}}
end

node_entry -->|"starts"| node_composition
node_composition -->|"initializes"| node_app_di
node_app_di -->|"creates per tab"| node_tab_di
node_tab_di -->|"provides"| node_tab_vm
node_tab_di -->|"binds lifetime"| node_tab_scope
node_composition -->|"hosts"| node_ui
node_ui -->|"renders and invokes"| node_tab_vm
node_open_vm -->|"opens repository"| node_usecases
node_tab_vm -->|"invokes"| node_usecases
node_tab_vm -->|"observes"| node_repository_state
node_usecases -->|"depends on"| node_contracts
node_usecases -->|"updates on refresh"| node_repository_state
node_contracts -->|"implemented by"| node_jgit
node_watcher -->|"triggers refresh"| node_usecases
node_jgit -->|"uses for remote transport"| node_credentials
node_jgit -->|"coordinates LFS transfers"| node_lfs
node_settings_contract -->|"implemented by"| node_settings_store
node_composition -.->|"packages with"| node_native

click node_entry "https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/main.kt"
click node_composition "https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/App.kt"
click node_app_di "https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/di/AppComponent.kt"
click node_tab_di "https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/di/TabComponent.kt"
click node_tab_vm "https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/TabViewModel.kt"
click node_ui "https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/ui/AppTab.kt"
click node_open_vm "https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/repositoryopen/RepositoryOpenViewModel.kt"
click node_repository_state "https://github.com/jetpackduba/gitnuro/blob/main/domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/repositories/RepositoryStateRepository.kt"
click node_tab_scope "https://github.com/jetpackduba/gitnuro/blob/main/domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/TabCoroutineScope.kt"
click node_settings_contract "https://github.com/jetpackduba/gitnuro/blob/main/domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/repositories/AppSettingsRepository.kt"
click node_jgit "https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/JGit.kt"
click node_watcher "https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/FileChangesWatcher.kt"
click node_credentials "https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/credentials/HttpCredentialsProvider.kt"
click node_lfs "https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/repositories/NetworkLfsRepository.kt"
click node_settings_store "https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/UserSettingsDataStore.kt"
click node_native "https://github.com/jetpackduba/gitnuro/blob/main/rs/src/lib.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_composition,node_app_di,node_tab_di,node_tab_vm,node_ui,node_open_vm toneBlue
class node_contracts,node_usecases,node_repository_state,node_tab_scope,node_settings_contract toneAmber
class node_jgit,node_watcher,node_credentials,node_lfs,node_settings_store,node_native toneMint
```

## Components

### Desktop application

- [Desktop entry point](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/main.kt): Kotlin main · `app/src/main/kotlin/com/jetpackduba/gitnuro/main.kt`
- [Application composition](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/App.kt): Compose root · `app/src/main/kotlin/com/jetpackduba/gitnuro/App.kt`
- [App DI scope](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/di/AppComponent.kt): DI component · Owns global application dependencies. · `app/src/main/kotlin/com/jetpackduba/gitnuro/di/AppComponent.kt`
- [Tab DI scope](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/di/TabComponent.kt): DI component · Creates isolated object graphs per repository tab. · `app/src/main/kotlin/com/jetpackduba/gitnuro/di/TabComponent.kt`
- [Repository tab state](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/TabViewModel.kt): tab view model · Owns a tab's repository state and operation lifetime. · `app/src/main/kotlin/com/jetpackduba/gitnuro/TabViewModel.kt`
- [Tab UI and screens](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/ui/AppTab.kt): Compose presentation · Renders repository state and dispatches user actions. · `app/src/main/kotlin/com/jetpackduba/gitnuro/ui/AppTab.kt`
- [Open repository flow](https://github.com/jetpackduba/gitnuro/blob/main/app/src/main/kotlin/com/jetpackduba/gitnuro/repositoryopen/RepositoryOpenViewModel.kt): view model · `app/src/main/kotlin/com/jetpackduba/gitnuro/repositoryopen/RepositoryOpenViewModel.kt`

### Domain layer

- **Git service contracts**: domain interfaces · Abstractions consumed by use cases instead of data implementations.
- **Git operation use cases**: domain orchestration · Validates, sequences operations, refreshes state, and handles errors.
- [Repository state](https://github.com/jetpackduba/gitnuro/blob/main/domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/repositories/RepositoryStateRepository.kt): state repository · Shared domain state exposed to the presentation layer. · `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/repositories/RepositoryStateRepository.kt`
- [Tab coroutine lifetime](https://github.com/jetpackduba/gitnuro/blob/main/domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/TabCoroutineScope.kt): coroutine scope · `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/TabCoroutineScope.kt`
- [Settings contract](https://github.com/jetpackduba/gitnuro/blob/main/domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/repositories/AppSettingsRepository.kt): domain repository · `domain/src/main/kotlin/com/jetpackduba/gitnuro/domain/repositories/AppSettingsRepository.kt`

### Data and integrations

- [JGit Git engine](https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/JGit.kt): Git integration · Executes Git actions and maps JGit objects into domain models. · `data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/JGit.kt`
- [Working-tree watcher](https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/FileChangesWatcher.kt): filesystem monitor · `data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/FileChangesWatcher.kt`
- [HTTP and SSH credentials](https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/credentials/HttpCredentialsProvider.kt): transport credentials · Supplies credentials to JGit remote transport. · `data/src/main/kotlin/com/jetpackduba/gitnuro/data/git/credentials/HttpCredentialsProvider.kt`
- [Git LFS pipeline](https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/repositories/NetworkLfsRepository.kt): network repository · Authenticates and transfers LFS objects separately from Git transport. · `data/src/main/kotlin/com/jetpackduba/gitnuro/data/repositories/NetworkLfsRepository.kt`
- [User settings store](https://github.com/jetpackduba/gitnuro/blob/main/data/src/main/kotlin/com/jetpackduba/gitnuro/data/UserSettingsDataStore.kt): persistent datastore · `data/src/main/kotlin/com/jetpackduba/gitnuro/data/UserSettingsDataStore.kt`
- [Native interop and packaging](https://github.com/jetpackduba/gitnuro/blob/main/rs/src/lib.rs): Rust/UniFFI support · Supports native integration alongside the JVM desktop runtime. · `rs/src/lib.rs`

## Connections

- Desktop entry point → Application composition: starts
- Application composition → App DI scope: initializes
- App DI scope → Tab DI scope: creates per tab
- Tab DI scope → Repository tab state: provides
- Tab DI scope → Tab coroutine lifetime: binds lifetime
- Application composition → Tab UI and screens: hosts
- Tab UI and screens → Repository tab state: renders and invokes
- Open repository flow → Git operation use cases: opens repository
- Repository tab state → Git operation use cases: invokes
- Repository tab state → Repository state: observes
- Git operation use cases → Git service contracts: depends on
- Git operation use cases → Repository state: updates on refresh
- Git service contracts → JGit Git engine: implemented by
- Working-tree watcher → Git operation use cases: triggers refresh
- JGit Git engine → HTTP and SSH credentials: uses for remote transport
- JGit Git engine → Git LFS pipeline: coordinates LFS transfers
- Settings contract → User settings store: implemented by
- Application composition → Native interop and packaging: packages with
