# pansariji/dropit architecture

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

- Interactive diagram: https://gitdiagram.com/pansariji/dropit
- Repository: https://github.com/pansariji/dropit

## Overview

DropIt is a desktop file-sharing app whose main workflow is selecting Send or Receive, choosing a PC-to-PC or mobile-browser channel, transferring files or folders, and viewing live progress. The graph separates the Flet interface, transfer coordination, network transports, and shared runtime support. README capabilities include passcode discovery/direct-IP sending, QR-based browser upload and download, folder ZIP streaming, and telemetry. Some wiring is documented or indexed rather than shown in full source excerpts; those edges cite the README where appropriate.

Main entry points: [`p2p/server.py`](https://github.com/pansariji/dropit/blob/main/p2p/server.py) (P2P receiver), [`web/server.py`](https://github.com/pansariji/dropit/blob/main/web/server.py) (Browser upload), [`ui/receive_view.py`](https://github.com/pansariji/dropit/blob/main/ui/receive_view.py) (Receive screen), [`ui/send_view.py`](https://github.com/pansariji/dropit/blob/main/ui/send_view.py) (Send screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_main["App bootstrap<br/>[main.py]"]
  node_home["Home screen<br/>[home_view.py]"]
  node_receive["Receive screen<br/>[receive_view.py]"]
  node_send["Send screen<br/>[send_view.py]"]
  node_telemetry["Transfer dashboard<br/>[transfer_view.py]"]
end

subgraph group_coordination["Transfer coordination"]
end

subgraph group_transport["Network transport"]
  node_p2pclient["P2P sender<br/>[client.py]"]
  node_p2pserver["P2P receiver<br/>[server.py]"]
  node_webreceiver["Browser upload<br/>[server.py]"]
  node_websender["Browser download<br/>[server.py]"]
  node_templates["Mobile web interface<br/>[templates.py]"]
end

subgraph group_shared["Shared runtime"]
  node_metrics["Transfer metrics<br/>[utils.py]"]
  node_networkutils["Network utilities<br/>[utils.py]"]
  node_config["App configuration<br/>[config.py]"]
end

node_user(("Desktop user"))
node_mobile(("Mobile user"))
node_downloads["Local downloads"]

node_user -->|"launches"| node_main
node_main -->|"routes to"| node_home
node_main -->|"routes to"| node_receive
node_main -->|"routes to"| node_send
node_home -->|"opens"| node_receive
node_home -->|"opens"| node_send
node_user -->|"chooses receive"| node_receive
node_user -->|"chooses send"| node_send
node_receive -->|"starts PC receiver"| node_p2pserver
node_receive -->|"starts browser receiver"| node_webreceiver
node_send -->|"starts PC sender"| node_p2pclient
node_send -->|"starts browser sender"| node_websender
node_receive -->|"shows progress"| node_telemetry
node_send -->|"shows progress"| node_telemetry
node_p2pclient -->|"discovers and streams to"| node_p2pserver
node_p2pserver -->|"writes received files"| node_downloads
node_webreceiver -->|"writes uploads"| node_downloads
node_mobile -->|"opens QR page"| node_templates
node_templates -->|"uploads to"| node_webreceiver
node_websender -->|"renders page"| node_templates
node_mobile -->|"downloads from"| node_websender
node_p2pclient -->|"tracks transfer"| node_metrics
node_p2pserver -->|"tracks transfer"| node_metrics
node_webreceiver -->|"tracks transfer"| node_metrics
node_websender -.->|"tracks transfer"| node_metrics
node_p2pclient -->|"uses helpers"| node_networkutils
node_p2pserver -->|"uses helpers"| node_networkutils
node_webreceiver -->|"uses helpers"| node_networkutils
node_websender -->|"uses helpers"| node_networkutils
node_p2pclient -->|"reads settings"| node_config
node_p2pserver -->|"reads settings"| node_config
node_webreceiver -->|"reads settings"| node_config
node_websender -->|"reads settings"| node_config

click node_main "https://github.com/pansariji/dropit/blob/main/main.py"
click node_home "https://github.com/pansariji/dropit/blob/main/ui/home_view.py"
click node_receive "https://github.com/pansariji/dropit/blob/main/ui/receive_view.py"
click node_send "https://github.com/pansariji/dropit/blob/main/ui/send_view.py"
click node_telemetry "https://github.com/pansariji/dropit/blob/main/ui/transfer_view.py"
click node_p2pclient "https://github.com/pansariji/dropit/blob/main/p2p/client.py"
click node_p2pserver "https://github.com/pansariji/dropit/blob/main/p2p/server.py"
click node_webreceiver "https://github.com/pansariji/dropit/blob/main/web/server.py"
click node_websender "https://github.com/pansariji/dropit/blob/main/web/server.py"
click node_templates "https://github.com/pansariji/dropit/blob/main/web/templates.py"
click node_metrics "https://github.com/pansariji/dropit/blob/main/utils.py"
click node_networkutils "https://github.com/pansariji/dropit/blob/main/utils.py"
click node_config "https://github.com/pansariji/dropit/blob/main/config.py"

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_main,node_home,node_receive,node_send,node_telemetry,node_user,node_mobile toneBlue
class node_p2pclient,node_p2pserver,node_webreceiver,node_websender,node_templates toneMint
class node_metrics,node_networkutils,node_config toneRose
class node_downloads toneIndigo
```

## Components

### Desktop interface

- [App bootstrap](https://github.com/pansariji/dropit/blob/main/main.py): `main.py`
- [Home screen](https://github.com/pansariji/dropit/blob/main/ui/home_view.py): `ui/home_view.py`
- [Receive screen](https://github.com/pansariji/dropit/blob/main/ui/receive_view.py): `ui/receive_view.py`
- [Send screen](https://github.com/pansariji/dropit/blob/main/ui/send_view.py): `ui/send_view.py`
- [Transfer dashboard](https://github.com/pansariji/dropit/blob/main/ui/transfer_view.py): `ui/transfer_view.py`

### Network transport

- [P2P sender](https://github.com/pansariji/dropit/blob/main/p2p/client.py): `p2p/client.py`
- [P2P receiver](https://github.com/pansariji/dropit/blob/main/p2p/server.py): `p2p/server.py`
- [Browser upload](https://github.com/pansariji/dropit/blob/main/web/server.py): `web/server.py`
- [Browser download](https://github.com/pansariji/dropit/blob/main/web/server.py): `web/server.py`
- [Mobile web interface](https://github.com/pansariji/dropit/blob/main/web/templates.py): `web/templates.py`

### Shared runtime

- [Transfer metrics](https://github.com/pansariji/dropit/blob/main/utils.py): `utils.py`
- [Network utilities](https://github.com/pansariji/dropit/blob/main/utils.py): `utils.py`
- [App configuration](https://github.com/pansariji/dropit/blob/main/config.py): `config.py`

### Other components

- **Desktop user**
- **Mobile user**
- **Local downloads**

## Connections

- Desktop user → App bootstrap: launches (evidence: `README.md`)
- App bootstrap → Home screen: routes to (evidence: `main.py`)
- App bootstrap → Receive screen: routes to (evidence: `main.py`)
- App bootstrap → Send screen: routes to (evidence: `main.py`)
- Home screen → Receive screen: opens (evidence: `ui/home_view.py`)
- Home screen → Send screen: opens (evidence: `ui/home_view.py`)
- Desktop user → Receive screen: chooses receive (evidence: `README.md`)
- Desktop user → Send screen: chooses send (evidence: `README.md`)
- Receive screen → P2P receiver: starts PC receiver (evidence: `README.md`)
- Receive screen → Browser upload: starts browser receiver (evidence: `README.md`)
- Send screen → P2P sender: starts PC sender (evidence: `README.md`)
- Send screen → Browser download: starts browser sender (evidence: `README.md`)
- Receive screen → Transfer dashboard: shows progress (evidence: `ui/receive_view.py`)
- Send screen → Transfer dashboard: shows progress (evidence: `ui/send_view.py`)
- P2P sender → P2P receiver: discovers and streams to (evidence: `p2p/client.py`)
- P2P receiver → Local downloads: writes received files (evidence: `README.md`)
- Browser upload → Local downloads: writes uploads (evidence: `web/server.py`)
- Mobile user → Mobile web interface: opens QR page (evidence: `README.md`)
- Mobile web interface → Browser upload: uploads to (evidence: `web/server.py`)
- Browser download → Mobile web interface: renders page (evidence: `web/server.py`)
- Mobile user → Browser download: downloads from (evidence: `README.md`)
- P2P sender → Transfer metrics: tracks transfer (evidence: `p2p/client.py`)
- P2P receiver → Transfer metrics: tracks transfer (evidence: `p2p/server.py`)
- Browser upload → Transfer metrics: tracks transfer (evidence: `web/server.py`)
- Browser download → Transfer metrics: tracks transfer (evidence: `web/server.py`)
- P2P sender → Network utilities: uses helpers (evidence: `p2p/client.py`)
- P2P receiver → Network utilities: uses helpers (evidence: `p2p/server.py`)
- Browser upload → Network utilities: uses helpers (evidence: `web/server.py`)
- Browser download → Network utilities: uses helpers (evidence: `web/server.py`)
- P2P sender → App configuration: reads settings (evidence: `p2p/client.py`)
- P2P receiver → App configuration: reads settings (evidence: `p2p/server.py`)
- Browser upload → App configuration: reads settings (evidence: `web/server.py`)
- Browser download → App configuration: reads settings (evidence: `web/server.py`)
