# anismuhammed/luma_transfer architecture

> Architecture diagram of the GitHub repository anismuhammed/luma_transfer, 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/anismuhammed/luma_transfer
- Repository: https://github.com/anismuhammed/luma_transfer

## Overview

This is a Flutter application whose source tree suggests an optical file-transfer product: file selection, sending and receiving, transfer status, history, downloads, and settings. The README is only the default Flutter starter text and documents no user workflow. Dart implementation excerpts were not provided, so the graph identifies the evident product subsystems but leaves their connections unverified rather than inferring call order. Native platform runner and generated plugin files are omitted as framework scaffolding.

Main entry points: [`lib/features/home/main_shell.dart`](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/home/main_shell.dart) (Home shell), [`lib/features/sender/sender_screen.dart`](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/sender/sender_screen.dart) (Sender), [`lib/services/transfer_service.dart`](https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/transfer_service.dart) (Transfer service), [`lib/features/file_picker/file_picker_screen.dart`](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/file_picker/file_picker_screen.dart) (File selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["App entry<br/>[main.dart]"]
  node_navigation["Navigation<br/>[app_router.dart]"]
  node_home["Home shell<br/>[main_shell.dart]"]
  node_filepicker["File selection"]
  node_downloads["Downloads<br/>[downloads_tab.dart]"]
  node_settings["Settings<br/>[settings_tab.dart]"]
end

subgraph group_transfer["Transfer workflow"]
  node_sender["Sender<br/>[sender_screen.dart]"]
  node_preparing["Prepare transfer"]
  node_receiver["Receiver"]
  node_receiving["Receive transfer"]
  node_complete["Transfer result"]
  node_transferdetails["Transfer details"]
end

subgraph group_services["Application services"]
  node_transferservice["Transfer service"]
  node_opticalservice["Optical transfer"]
  node_fileservice["File services<br/>[file_service.dart]"]
  node_devicefiles["Device files"]
  node_history[("Transfer history")]
  node_videodownload["Video downloads"]
  node_settingsservice[("Settings storage")]
end

subgraph group_engine["Optical engine"]
  node_packet["Packet handling"]
  node_encoder["Frame encoder<br/>[frame_encoder.dart]"]
  node_decoder["Frame decoder<br/>[frame_decoder.dart]"]
  node_receiveengine["Optical receiver"]
end

node_user(("User"))

node_user -.->|"opens"| node_app
node_app -.->|"routes via"| node_navigation
node_navigation -.->|"shows"| node_home
node_home -.->|"offers selection"| node_filepicker
node_filepicker -.->|"starts sending"| node_sender
node_sender -.->|"prepares"| node_preparing
node_receiver -.->|"starts receiving"| node_receiving
node_sender -.->|"uses"| node_transferservice
node_receiving -.->|"uses"| node_transferservice
node_transferservice -.->|"transfers via"| node_opticalservice
node_opticalservice -.->|"handles packets"| node_packet
node_packet -.->|"encodes frames"| node_encoder
node_packet -.->|"decodes frames"| node_decoder
node_receiver -.->|"receives optically"| node_receiveengine
node_transferservice -.->|"reports result"| node_complete
node_complete -.->|"records transfer"| node_history
node_home -.->|"offers downloads"| node_downloads
node_downloads -.->|"uses"| node_videodownload
node_filepicker -.->|"browses files"| node_devicefiles
node_sender -.->|"uses"| node_fileservice
node_home -.->|"offers settings"| node_settings
node_settings -.->|"uses"| node_settingsservice
node_history -.->|"shows details"| node_transferdetails

click node_app "https://github.com/anismuhammed/luma_transfer/blob/main/lib/main.dart"
click node_navigation "https://github.com/anismuhammed/luma_transfer/blob/main/lib/navigation/app_router.dart"
click node_home "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/home/main_shell.dart"
click node_filepicker "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/file_picker/file_picker_screen.dart"
click node_sender "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/sender/sender_screen.dart"
click node_preparing "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/preparing/preparing_screen.dart"
click node_receiver "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/receiver/receiver_screen.dart"
click node_receiving "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/receiving/receiving_screen.dart"
click node_complete "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/transfer_complete/transfer_complete_screen.dart"
click node_transferdetails "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/transfer_details/transfer_details_screen.dart"
click node_transferservice "https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/transfer_service.dart"
click node_opticalservice "https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/optical_transfer_service.dart"
click node_fileservice "https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/file_service.dart"
click node_devicefiles "https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/device_file_service.dart"
click node_history "https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/history_service.dart"
click node_packet "https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/packet_service.dart"
click node_encoder "https://github.com/anismuhammed/luma_transfer/blob/main/lib/engine/frame_encoder.dart"
click node_decoder "https://github.com/anismuhammed/luma_transfer/blob/main/lib/engine/frame_decoder.dart"
click node_receiveengine "https://github.com/anismuhammed/luma_transfer/blob/main/lib/engine/real_optical_receive_engine.dart"
click node_downloads "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/downloads/downloads_tab.dart"
click node_videodownload "https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/video_download_service.dart"
click node_settings "https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/settings/settings_tab.dart"
click node_settingsservice "https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/settings_service.dart"

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_navigation,node_home,node_filepicker,node_downloads,node_settings,node_user toneBlue
class node_sender,node_preparing,node_receiver,node_receiving,node_complete,node_transferdetails toneAmber
class node_transferservice,node_opticalservice,node_fileservice,node_devicefiles,node_history,node_videodownload,node_settingsservice toneMint
class node_packet,node_encoder,node_decoder,node_receiveengine toneRose
```

## Components

### App experience

- [App entry](https://github.com/anismuhammed/luma_transfer/blob/main/lib/main.dart): `lib/main.dart`
- [Navigation](https://github.com/anismuhammed/luma_transfer/blob/main/lib/navigation/app_router.dart): `lib/navigation/app_router.dart`
- [Home shell](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/home/main_shell.dart): `lib/features/home/main_shell.dart`
- [File selection](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/file_picker/file_picker_screen.dart): `lib/features/file_picker/file_picker_screen.dart`
- [Downloads](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/downloads/downloads_tab.dart): `lib/features/downloads/downloads_tab.dart`
- [Settings](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/settings/settings_tab.dart): `lib/features/settings/settings_tab.dart`

### Transfer workflow

- [Sender](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/sender/sender_screen.dart): `lib/features/sender/sender_screen.dart`
- [Prepare transfer](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/preparing/preparing_screen.dart): `lib/features/preparing/preparing_screen.dart`
- [Receiver](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/receiver/receiver_screen.dart): `lib/features/receiver/receiver_screen.dart`
- [Receive transfer](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/receiving/receiving_screen.dart): `lib/features/receiving/receiving_screen.dart`
- [Transfer result](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/transfer_complete/transfer_complete_screen.dart): `lib/features/transfer_complete/transfer_complete_screen.dart`
- [Transfer details](https://github.com/anismuhammed/luma_transfer/blob/main/lib/features/transfer_details/transfer_details_screen.dart): `lib/features/transfer_details/transfer_details_screen.dart`

### Application services

- [Transfer service](https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/transfer_service.dart): `lib/services/transfer_service.dart`
- [Optical transfer](https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/optical_transfer_service.dart): `lib/services/optical_transfer_service.dart`
- [File services](https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/file_service.dart): `lib/services/file_service.dart`
- [Device files](https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/device_file_service.dart): `lib/services/device_file_service.dart`
- [Transfer history](https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/history_service.dart): `lib/services/history_service.dart`
- [Video downloads](https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/video_download_service.dart): `lib/services/video_download_service.dart`
- [Settings storage](https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/settings_service.dart): `lib/services/settings_service.dart`

### Optical engine

- [Packet handling](https://github.com/anismuhammed/luma_transfer/blob/main/lib/services/packet_service.dart): `lib/services/packet_service.dart`
- [Frame encoder](https://github.com/anismuhammed/luma_transfer/blob/main/lib/engine/frame_encoder.dart): `lib/engine/frame_encoder.dart`
- [Frame decoder](https://github.com/anismuhammed/luma_transfer/blob/main/lib/engine/frame_decoder.dart): `lib/engine/frame_decoder.dart`
- [Optical receiver](https://github.com/anismuhammed/luma_transfer/blob/main/lib/engine/real_optical_receive_engine.dart): `lib/engine/real_optical_receive_engine.dart`

### Other components

- **User**

## Connections

- User → App entry: opens
- App entry → Navigation: routes via
- Navigation → Home shell: shows
- Home shell → File selection: offers selection
- File selection → Sender: starts sending
- Sender → Prepare transfer: prepares
- Receiver → Receive transfer: starts receiving
- Sender → Transfer service: uses
- Receive transfer → Transfer service: uses
- Transfer service → Optical transfer: transfers via
- Optical transfer → Packet handling: handles packets
- Packet handling → Frame encoder: encodes frames
- Packet handling → Frame decoder: decodes frames
- Receiver → Optical receiver: receives optically
- Transfer service → Transfer result: reports result
- Transfer result → Transfer history: records transfer
- Home shell → Downloads: offers downloads
- Downloads → Video downloads: uses
- File selection → Device files: browses files
- Sender → File services: uses
- Home shell → Settings: offers settings
- Settings → Settings storage: uses
- Transfer history → Transfer details: shows details
