# praveen0586/bridge--mac-to-android-connect architecture

> Architecture diagram of the GitHub repository praveen0586/bridge--mac-to-android-connect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/praveen0586/bridge--mac-to-android-connect
- Repository: https://github.com/praveen0586/bridge--mac-to-android-connect

## Overview

The repository appears to be a Flutter desktop tool for connecting to Android devices, browsing their files, and transferring files through ADB. The README is only the Flutter starter-project template, and no Dart implementation was excerpted, so the feature flow and links among its Dart components are provisional. Native Windows and Linux startup relationships are supported by excerpts; the platform runner components below are included because the source index identifies them as core modules.

Main entry points: [`lib/core/adb/adb_client.dart`](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/core/adb/adb_client.dart) (ADB client), [`lib/features/device/controller/device_controller.dart`](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/controller/device_controller.dart) (Device controller), [`lib/features/device/presentation/device_screen.dart`](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/presentation/device_screen.dart) (Device screen), [`lib/features/browser/controller/browser_controller.dart`](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/controller/browser_controller.dart) (Browser controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Flutter app"]
  node_app["App entry<br/>[main.dart]"]
end

subgraph group_device["Device access"]
  node_device_screen["Device screen<br/>[device_screen.dart]"]
  node_device_controller["Device controller"]
  node_device_detection["Device detection"]
  node_device_info["Device info"]
  node_device_model["Device metadata"]
  node_adb_client["ADB client<br/>[adb_client.dart]"]
  node_adb_process["ADB process"]
  node_adb_resolver["ADB resolver"]
  node_adb_asset["Bundled ADB"]
end

subgraph group_files["File workflows"]
  node_browser_view["File browser"]
  node_browser_controller["Browser controller"]
  node_browser_service["Browser service"]
  node_browser_parser["Listing parser"]
  node_remote_entry["Remote entries"]
  node_transfer_controller["Transfer controller"]
  node_transfer_service["Transfer service"]
  node_transfer_state["Transfer state"]
end

subgraph group_platform["Desktop hosts"]
  node_windows_main["Windows startup<br/>[main.cpp]"]
  node_windows_flutter["Windows Flutter host<br/>[flutter_window.h]"]
  node_windows_window["Windows window<br/>[win32_window.h]"]
  node_linux_main["Linux startup<br/>[main.cc]"]
  node_linux_app["Linux app host<br/>[my_application.h]"]
  node_linux_plugins["Linux plugin registration"]
  node_windows_plugins["Windows plugin registration"]
  node_macos_plugins["macOS plugin registration"]
end

node_user(("User"))
node_android(("Android device"))

node_user -.->|"opens"| node_app
node_app -.->|"shows"| node_device_screen
node_device_screen -.->|"delegates to"| node_device_controller
node_device_controller -.->|"checks devices"| node_device_detection
node_device_controller -.->|"loads details"| node_device_info
node_device_detection -.->|"queries via"| node_adb_client
node_device_info -.->|"queries via"| node_adb_client
node_adb_client -.->|"runs commands"| node_adb_process
node_adb_process -.->|"resolves executable"| node_adb_resolver
node_adb_resolver -.->|"may use"| node_adb_asset
node_adb_client -.->|"communicates with"| node_android
node_device_controller -.->|"uses"| node_device_model
node_device_screen -.->|"opens browser"| node_browser_view
node_browser_view -.->|"delegates to"| node_browser_controller
node_browser_controller -.->|"requests listings"| node_browser_service
node_browser_service -.->|"uses"| node_adb_client
node_browser_service -.->|"parses output"| node_browser_parser
node_browser_parser -.->|"creates entries"| node_remote_entry
node_browser_controller -.->|"initiates transfer"| node_transfer_controller
node_transfer_controller -.->|"delegates to"| node_transfer_service
node_transfer_controller -.->|"updates state"| node_transfer_state
node_transfer_service -.->|"uses"| node_adb_client
node_windows_main -->|"creates"| node_windows_flutter
node_windows_flutter -->|"extends"| node_windows_window
node_linux_main -->|"starts"| node_linux_app

click node_app "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/main.dart"
click node_device_screen "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/presentation/device_screen.dart"
click node_device_controller "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/controller/device_controller.dart"
click node_device_detection "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/services/device_detection_service.dart"
click node_device_info "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/services/device_info_service.dart"
click node_device_model "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/models/device_metadata.dart"
click node_adb_client "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/core/adb/adb_client.dart"
click node_adb_process "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/core/adb/adb_process_manager.dart"
click node_adb_resolver "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/core/adb/adb_executable_resolver.dart"
click node_adb_asset "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/assets/bin/adb"
click node_browser_view "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/presentation/file_browser_view.dart"
click node_browser_controller "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/controller/browser_controller.dart"
click node_browser_service "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/services/file_browser_service.dart"
click node_browser_parser "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/services/file_browser_parser.dart"
click node_remote_entry "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/models/remote_file_entry.dart"
click node_transfer_controller "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/transfer/controller/transfer_controller.dart"
click node_transfer_service "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/transfer/services/transfer_service.dart"
click node_transfer_state "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/transfer/models/transfer_state.dart"
click node_windows_main "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/windows/runner/main.cpp"
click node_windows_flutter "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/windows/runner/flutter_window.h"
click node_windows_window "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/windows/runner/win32_window.h"
click node_linux_main "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/linux/runner/main.cc"
click node_linux_app "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/linux/runner/my_application.h"
click node_linux_plugins "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/linux/flutter/generated_plugin_registrant.h"
click node_windows_plugins "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/windows/flutter/generated_plugin_registrant.h"
click node_macos_plugins "https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/macos/Flutter/GeneratedPluginRegistrant.swift"

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_app,node_user toneBlue
class node_device_screen,node_device_controller,node_device_detection,node_device_info,node_device_model,node_adb_client,node_adb_process,node_adb_resolver,node_adb_asset toneAmber
class node_browser_view,node_browser_controller,node_browser_service,node_browser_parser,node_remote_entry,node_transfer_controller,node_transfer_service,node_transfer_state toneMint
class node_windows_main,node_windows_flutter,node_windows_window,node_linux_main,node_linux_app,node_linux_plugins,node_windows_plugins,node_macos_plugins toneRose
class node_android toneIndigo
```

## Components

### Flutter app

- [App entry](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/main.dart): `lib/main.dart`

### Device access

- [Device screen](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/presentation/device_screen.dart): `lib/features/device/presentation/device_screen.dart`
- [Device controller](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/controller/device_controller.dart): `lib/features/device/controller/device_controller.dart`
- [Device detection](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/services/device_detection_service.dart): `lib/features/device/services/device_detection_service.dart`
- [Device info](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/services/device_info_service.dart): `lib/features/device/services/device_info_service.dart`
- [Device metadata](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/device/models/device_metadata.dart): `lib/features/device/models/device_metadata.dart`
- [ADB client](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/core/adb/adb_client.dart): `lib/core/adb/adb_client.dart`
- [ADB process](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/core/adb/adb_process_manager.dart): `lib/core/adb/adb_process_manager.dart`
- [ADB resolver](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/core/adb/adb_executable_resolver.dart): `lib/core/adb/adb_executable_resolver.dart`
- [Bundled ADB](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/assets/bin/adb): `assets/bin/adb`

### File workflows

- [File browser](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/presentation/file_browser_view.dart): `lib/features/browser/presentation/file_browser_view.dart`
- [Browser controller](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/controller/browser_controller.dart): `lib/features/browser/controller/browser_controller.dart`
- [Browser service](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/services/file_browser_service.dart): `lib/features/browser/services/file_browser_service.dart`
- [Listing parser](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/services/file_browser_parser.dart): `lib/features/browser/services/file_browser_parser.dart`
- [Remote entries](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/browser/models/remote_file_entry.dart): `lib/features/browser/models/remote_file_entry.dart`
- [Transfer controller](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/transfer/controller/transfer_controller.dart): `lib/features/transfer/controller/transfer_controller.dart`
- [Transfer service](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/transfer/services/transfer_service.dart): `lib/features/transfer/services/transfer_service.dart`
- [Transfer state](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/lib/features/transfer/models/transfer_state.dart): `lib/features/transfer/models/transfer_state.dart`

### Desktop hosts

- [Windows startup](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Windows Flutter host](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/windows/runner/flutter_window.h): `windows/runner/flutter_window.h`
- [Windows window](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/windows/runner/win32_window.h): `windows/runner/win32_window.h`
- [Linux startup](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/linux/runner/main.cc): `linux/runner/main.cc`
- [Linux app host](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/linux/runner/my_application.h): `linux/runner/my_application.h`
- [Linux plugin registration](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/linux/flutter/generated_plugin_registrant.h): `linux/flutter/generated_plugin_registrant.h`
- [Windows plugin registration](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/windows/flutter/generated_plugin_registrant.h): `windows/flutter/generated_plugin_registrant.h`
- [macOS plugin registration](https://github.com/praveen0586/bridge--mac-to-android-connect/blob/master/macos/Flutter/GeneratedPluginRegistrant.swift): `macos/Flutter/GeneratedPluginRegistrant.swift`

### Other components

- **User**
- **Android device**

## Connections

- User → App entry: opens
- App entry → Device screen: shows
- Device screen → Device controller: delegates to
- Device controller → Device detection: checks devices
- Device controller → Device info: loads details
- Device detection → ADB client: queries via
- Device info → ADB client: queries via
- ADB client → ADB process: runs commands
- ADB process → ADB resolver: resolves executable
- ADB resolver → Bundled ADB: may use
- ADB client → Android device: communicates with
- Device controller → Device metadata: uses
- Device screen → File browser: opens browser
- File browser → Browser controller: delegates to
- Browser controller → Browser service: requests listings
- Browser service → ADB client: uses
- Browser service → Listing parser: parses output
- Listing parser → Remote entries: creates entries
- Browser controller → Transfer controller: initiates transfer
- Transfer controller → Transfer service: delegates to
- Transfer controller → Transfer state: updates state
- Transfer service → ADB client: uses
- Windows startup → Windows Flutter host: creates (evidence: `windows/runner/main.cpp`)
- Windows Flutter host → Windows window: extends (evidence: `windows/runner/flutter_window.h`)
- Linux startup → Linux app host: starts (evidence: `linux/runner/main.cc`)
