# drenzzz/adbkit architecture

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

- Interactive diagram: https://gitdiagram.com/drenzzz/adbkit
- Repository: https://github.com/drenzzz/adbkit

## Overview

ADBKit is a desktop Android-device toolkit: users select or connect a device, then manage apps and files, inspect device status, run shell/logcat, flash images, or mirror and record with scrcpy. Its setup and settings flows locate or download ADB, Fastboot, and scrcpy and configure preferences. The map preserves these user-facing domains and the Go service layer behind the Wails bindings. Some backend wiring is unsampled; README-documented relationships are cited, and uncertain internal calls are omitted.

Main entry points: [`internal/app/app.go`](https://github.com/drenzzz/adbkit/blob/main/internal/app/app.go) (Application host), [`frontend/src/App.tsx`](https://github.com/drenzzz/adbkit/blob/main/frontend/src/App.tsx) (Page router), [`frontend/bindings/ADBKit/internal/app/app.ts`](https://github.com/drenzzz/adbkit/blob/main/frontend/bindings/ADBKit/internal/app/app.ts) (Wails API bindings), [`frontend/src/routes/DashboardPage.tsx`](https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/DashboardPage.tsx) (Dashboard and devices)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_router["Page router<br/>[App.tsx]"]
  node_dashboard["Dashboard and devices<br/>[DashboardPage.tsx]"]
  node_appsui["App manager<br/>[AppsPage.tsx]"]
  node_filesui["File explorer<br/>[FilesPage.tsx]"]
  node_flashui["Flasher<br/>[FlasherPage.tsx]"]
  node_shellui["Terminal and Logcat<br/>[TerminalPage.tsx]"]
  node_scrcpyui["Scrcpy controls<br/>[ScrcpyPage.tsx]"]
  node_setupui["Setup and settings<br/>[SettingsPage.tsx]"]
end

subgraph group_bridge["Wails bridge"]
  node_bindings["Wails API bindings<br/>[app.ts]"]
end

subgraph group_services["Go domain services"]
  node_apphost["Application host<br/>[app.go]"]
  node_device["Device operations<br/>[service.go]"]
  node_packages["Package manager<br/>[service.go]"]
  node_files["File operations<br/>[service.go]"]
  node_flasher["Fastboot and flashing"]
  node_terminal["Shell and Logcat"]
  node_scrcpy["Mirroring and recording<br/>[service.go]"]
  node_binaries["Binary discovery<br/>[service.go]"]
  node_downloads["Managed downloads<br/>[service.go]"]
  node_audit["Audit logs<br/>[audit_log.go]"]
end

subgraph group_runtime["Shared runtime"]
  node_settings["Preferences and config<br/>[settings.go]"]
end

node_user(("Desktop user"))

node_user -->|"uses"| node_router
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_appsui
node_router -->|"routes to"| node_filesui
node_router -->|"routes to"| node_flashui
node_router -->|"routes to"| node_shellui
node_router -->|"routes to"| node_scrcpyui
node_router -->|"routes to"| node_setupui
node_dashboard -.->|"requests device work"| node_bindings
node_appsui -.->|"requests package work"| node_bindings
node_filesui -->|"requests file work"| node_bindings
node_flashui -.->|"requests flashing"| node_bindings
node_shellui -.->|"requests shell work"| node_bindings
node_scrcpyui -.->|"requests mirroring"| node_bindings
node_setupui -.->|"configures tools"| node_bindings
node_bindings -.->|"invokes methods"| node_apphost
node_apphost -.->|"delegates device work"| node_device
node_apphost -.->|"delegates package work"| node_packages
node_apphost -.->|"delegates file work"| node_files
node_apphost -.->|"delegates flashing"| node_flasher
node_apphost -.->|"delegates shell work"| node_terminal
node_apphost -.->|"delegates mirroring"| node_scrcpy
node_apphost -.->|"checks tool setup"| node_binaries
node_apphost -.->|"requests downloads"| node_downloads
node_apphost -.->|"records operations"| node_audit
node_apphost -.->|"reads and saves"| node_settings
node_binaries -.->|"uses managed packages"| node_downloads

click node_router "https://github.com/drenzzz/adbkit/blob/main/frontend/src/App.tsx"
click node_dashboard "https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/DashboardPage.tsx"
click node_appsui "https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/AppsPage.tsx"
click node_filesui "https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/FilesPage.tsx"
click node_flashui "https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/FlasherPage.tsx"
click node_shellui "https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/TerminalPage.tsx"
click node_scrcpyui "https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/ScrcpyPage.tsx"
click node_setupui "https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/SettingsPage.tsx"
click node_bindings "https://github.com/drenzzz/adbkit/blob/main/frontend/bindings/ADBKit/internal/app/app.ts"
click node_apphost "https://github.com/drenzzz/adbkit/blob/main/internal/app/app.go"
click node_device "https://github.com/drenzzz/adbkit/blob/main/internal/device/service.go"
click node_packages "https://github.com/drenzzz/adbkit/blob/main/internal/package_mgr/service.go"
click node_files "https://github.com/drenzzz/adbkit/blob/main/internal/file/service.go"
click node_flasher "https://github.com/drenzzz/adbkit/blob/main/internal/flasher/fastboot_service.go"
click node_terminal "https://github.com/drenzzz/adbkit/blob/main/internal/shell/terminal_service.go"
click node_scrcpy "https://github.com/drenzzz/adbkit/blob/main/internal/scrcpy/service.go"
click node_binaries "https://github.com/drenzzz/adbkit/blob/main/internal/binary/service.go"
click node_downloads "https://github.com/drenzzz/adbkit/blob/main/internal/download/service.go"
click node_audit "https://github.com/drenzzz/adbkit/blob/main/internal/audit/audit_log.go"
click node_settings "https://github.com/drenzzz/adbkit/blob/main/internal/app/settings.go"

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_router,node_dashboard,node_appsui,node_filesui,node_flashui,node_shellui,node_scrcpyui,node_setupui,node_user toneBlue
class node_bindings toneAmber
class node_apphost,node_device,node_packages,node_files,node_flasher,node_terminal,node_scrcpy,node_binaries,node_downloads,node_audit toneMint
class node_settings toneRose
```

## Components

### Desktop interface

- [Page router](https://github.com/drenzzz/adbkit/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Dashboard and devices](https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/DashboardPage.tsx): `frontend/src/routes/DashboardPage.tsx`
- [App manager](https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/AppsPage.tsx): `frontend/src/routes/AppsPage.tsx`
- [File explorer](https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/FilesPage.tsx): `frontend/src/routes/FilesPage.tsx`
- [Flasher](https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/FlasherPage.tsx): `frontend/src/routes/FlasherPage.tsx`
- [Terminal and Logcat](https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/TerminalPage.tsx): `frontend/src/routes/TerminalPage.tsx`
- [Scrcpy controls](https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/ScrcpyPage.tsx): `frontend/src/routes/ScrcpyPage.tsx`
- [Setup and settings](https://github.com/drenzzz/adbkit/blob/main/frontend/src/routes/SettingsPage.tsx): `frontend/src/routes/SettingsPage.tsx`

### Wails bridge

- [Wails API bindings](https://github.com/drenzzz/adbkit/blob/main/frontend/bindings/ADBKit/internal/app/app.ts): `frontend/bindings/ADBKit/internal/app/app.ts`

### Go domain services

- [Application host](https://github.com/drenzzz/adbkit/blob/main/internal/app/app.go): `internal/app/app.go`
- [Device operations](https://github.com/drenzzz/adbkit/blob/main/internal/device/service.go): `internal/device/service.go`
- [Package manager](https://github.com/drenzzz/adbkit/blob/main/internal/package_mgr/service.go): `internal/package_mgr/service.go`
- [File operations](https://github.com/drenzzz/adbkit/blob/main/internal/file/service.go): `internal/file/service.go`
- [Fastboot and flashing](https://github.com/drenzzz/adbkit/blob/main/internal/flasher/fastboot_service.go): `internal/flasher/fastboot_service.go`
- [Shell and Logcat](https://github.com/drenzzz/adbkit/blob/main/internal/shell/terminal_service.go): `internal/shell/terminal_service.go`
- [Mirroring and recording](https://github.com/drenzzz/adbkit/blob/main/internal/scrcpy/service.go): `internal/scrcpy/service.go`
- [Binary discovery](https://github.com/drenzzz/adbkit/blob/main/internal/binary/service.go): `internal/binary/service.go`
- [Managed downloads](https://github.com/drenzzz/adbkit/blob/main/internal/download/service.go): `internal/download/service.go`
- [Audit logs](https://github.com/drenzzz/adbkit/blob/main/internal/audit/audit_log.go): `internal/audit/audit_log.go`

### Shared runtime

- [Preferences and config](https://github.com/drenzzz/adbkit/blob/main/internal/app/settings.go): `internal/app/settings.go`

### Other components

- **Desktop user**

## Connections

- Desktop user → Page router: uses (evidence: `README.md`)
- Page router → Dashboard and devices: routes to (evidence: `frontend/src/App.tsx`)
- Page router → App manager: routes to (evidence: `frontend/src/App.tsx`)
- Page router → File explorer: routes to (evidence: `frontend/src/App.tsx`)
- Page router → Flasher: routes to (evidence: `frontend/src/App.tsx`)
- Page router → Terminal and Logcat: routes to (evidence: `frontend/src/App.tsx`)
- Page router → Scrcpy controls: routes to (evidence: `frontend/src/App.tsx`)
- Page router → Setup and settings: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard and devices → Wails API bindings: requests device work (evidence: `README.md`)
- App manager → Wails API bindings: requests package work (evidence: `README.md`)
- File explorer → Wails API bindings: requests file work
- Flasher → Wails API bindings: requests flashing (evidence: `README.md`)
- Terminal and Logcat → Wails API bindings: requests shell work (evidence: `README.md`)
- Scrcpy controls → Wails API bindings: requests mirroring (evidence: `README.md`)
- Setup and settings → Wails API bindings: configures tools (evidence: `README.md`)
- Wails API bindings → Application host: invokes methods
- Application host → Device operations: delegates device work
- Application host → Package manager: delegates package work
- Application host → File operations: delegates file work
- Application host → Fastboot and flashing: delegates flashing
- Application host → Shell and Logcat: delegates shell work
- Application host → Mirroring and recording: delegates mirroring
- Application host → Binary discovery: checks tool setup
- Application host → Managed downloads: requests downloads
- Application host → Audit logs: records operations
- Application host → Preferences and config: reads and saves
- Binary discovery → Managed downloads: uses managed packages
