# vahdettina/drop_flow architecture

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

- Interactive diagram: https://gitdiagram.com/vahdettina/drop_flow
- Repository: https://github.com/vahdettina/drop_flow

## Overview

DropFlow is an Android peer-to-peer file-sharing app. Its documented main flow starts a temporary local server on the Android device; another device connects through a browser using the displayed IP address or QR code, then downloads shared files or uploads files back. The README also advertises Bluetooth sharing. Source excerpts were not provided, so the component mapping follows the file tree and the relationships shown here are limited to README-documented behavior.

Main entry points: [`dropflow/app/src/main/java/com/example/transfer/EmbeddedTransferServer.kt`](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/transfer/EmbeddedTransferServer.kt) (Local transfer server), [`dropflow/app/src/main/java/com/example/MainActivity.kt`](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/MainActivity.kt) (DropFlow app), [`dropflow/app/src/main/java/com/example/ui/screens/SendScreen.kt`](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/ui/screens/SendScreen.kt) (Send/receive), [`dropflow/app/src/main/java/com/example/util/BluetoothShareUtils.kt`](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/util/BluetoothShareUtils.kt) (Bluetooth sharing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_android_app["DropFlow app<br/>[MainActivity.kt]"]
  node_send_receive["Send/receive<br/>[SendScreen.kt]"]
  node_web_screen["Web share screen<br/>[WebShareScreen.kt]"]
end

subgraph group_transfer["Transfer runtime"]
  node_server["Local transfer server"]
  node_peer_discovery["Peer discovery"]
  node_transfer_client["Transfer client<br/>[TransferClient.kt]"]
  node_bluetooth["Bluetooth sharing"]
end

subgraph group_peer["Peer access"]
  node_browser_peer(("Browser peer"))
  node_shared_files["Shared files<br/>[StorageUtils.kt]"]
end

node_person(("App user"))

node_person -->|"opens"| node_android_app
node_android_app -->|"starts sharing"| node_send_receive
node_send_receive -->|"starts server"| node_server
node_server -->|"serves locally"| node_browser_peer
node_person -->|"scans QR or enters IP"| node_browser_peer
node_browser_peer -->|"downloads"| node_shared_files
node_browser_peer -->|"uploads to"| node_server
node_person -.->|"shares by Bluetooth"| node_bluetooth
node_person -->|"closes app; stops"| node_server

click node_android_app "https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/MainActivity.kt"
click node_send_receive "https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/ui/screens/SendScreen.kt"
click node_web_screen "https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/ui/screens/WebShareScreen.kt"
click node_server "https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/transfer/EmbeddedTransferServer.kt"
click node_peer_discovery "https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/transfer/PeerDiscoveryManager.kt"
click node_transfer_client "https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/transfer/TransferClient.kt"
click node_bluetooth "https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/util/BluetoothShareUtils.kt"
click node_shared_files "https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/util/StorageUtils.kt"

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_android_app,node_send_receive,node_web_screen,node_person toneBlue
class node_server,node_peer_discovery,node_transfer_client,node_bluetooth toneAmber
class node_browser_peer,node_shared_files toneMint
```

## Components

### App experience

- [DropFlow app](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/MainActivity.kt): `dropflow/app/src/main/java/com/example/MainActivity.kt`
- [Send/receive](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/ui/screens/SendScreen.kt): `dropflow/app/src/main/java/com/example/ui/screens/SendScreen.kt`
- [Web share screen](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/ui/screens/WebShareScreen.kt): `dropflow/app/src/main/java/com/example/ui/screens/WebShareScreen.kt`

### Transfer runtime

- [Local transfer server](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/transfer/EmbeddedTransferServer.kt): `dropflow/app/src/main/java/com/example/transfer/EmbeddedTransferServer.kt`
- [Peer discovery](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/transfer/PeerDiscoveryManager.kt): `dropflow/app/src/main/java/com/example/transfer/PeerDiscoveryManager.kt`
- [Transfer client](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/transfer/TransferClient.kt): `dropflow/app/src/main/java/com/example/transfer/TransferClient.kt`
- [Bluetooth sharing](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/util/BluetoothShareUtils.kt): `dropflow/app/src/main/java/com/example/util/BluetoothShareUtils.kt`

### Peer access

- **Browser peer**
- [Shared files](https://github.com/vahdettina/drop_flow/blob/main/dropflow/app/src/main/java/com/example/util/StorageUtils.kt): `dropflow/app/src/main/java/com/example/util/StorageUtils.kt`

### Other components

- **App user**

## Connections

- App user → DropFlow app: opens (evidence: `README.md`)
- DropFlow app → Send/receive: starts sharing (evidence: `README.md`)
- Send/receive → Local transfer server: starts server (evidence: `README.md`)
- Local transfer server → Browser peer: serves locally (evidence: `README.md`)
- App user → Browser peer: scans QR or enters IP (evidence: `README.md`)
- Browser peer → Shared files: downloads (evidence: `README.md`)
- Browser peer → Local transfer server: uploads to (evidence: `README.md`)
- App user → Bluetooth sharing: shares by Bluetooth (evidence: `README.md`)
- App user → Local transfer server: closes app; stops (evidence: `README.md`)
