# nacer-eddine05/aerlynk architecture

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

- Interactive diagram: https://gitdiagram.com/nacer-eddine05/aerlynk
- Repository: https://github.com/nacer-eddine05/aerlynk

## Overview

AerLynk is a Tauri desktop app for encrypted, bidirectional file transfer between a PC and a phone browser on the same LAN. The user starts a send or receive session, shares its QR code, and the phone downloads or uploads files; received uploads are authenticated before release. The graph separates the desktop UI, transfer/session serving, and LAN/security support. README documents the mobile-page/WASM flow and major safeguards; some backend and settings wiring is not visible in the sampled excerpts, so only documented or indexed relationships are shown.

Main entry points: [`src-tauri/src/commands.rs`](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/commands.rs) (Session commands), [`src-tauri/src/server/mod.rs`](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server/mod.rs) (Phone HTTP routes), [`src/App.tsx`](https://github.com/nacer-eddine05/aerlynk/blob/main/src/App.tsx) (App navigation), [`src/hooks/useTransfer.ts`](https://github.com/nacer-eddine05/aerlynk/blob/main/src/hooks/useTransfer.ts) (Transfer state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_app["App navigation<br/>[App.tsx]"]
  node_send["Send view<br/>[SendView.tsx]"]
  node_receive["Receive view<br/>[ReceiveView.tsx]"]
  node_qr["QR pairing card<br/>[QrCard.tsx]"]
  node_history["Transfer history<br/>[HistoryView.tsx]"]
  node_settings["Settings view<br/>[SettingsView.tsx]"]
  node_transfer_hook["Transfer state<br/>[useTransfer.ts]"]
  node_ipc["Tauri IPC<br/>[ipc.ts]"]
end

subgraph group_transfer["Transfer runtime"]
  node_commands["Session commands<br/>[commands.rs]"]
  node_registry[("Session registry<br/>[session.rs]")]
  node_manager["Server lifecycle<br/>[server_manager.rs]"]
  node_http["Phone HTTP routes<br/>[mod.rs]"]
  node_download["Encrypted download<br/>[download.rs]"]
  node_upload["Upload verification<br/>[upload.rs]"]
  node_assets["Mobile page assets<br/>[assets.rs]"]
end

subgraph group_network["LAN and security"]
  node_net["LAN discovery<br/>[net.rs]"]
  node_reachability["Reachability checks<br/>[reachability.rs]"]
  node_firewall["Firewall repair<br/>[firewall.rs]"]
  node_safety["File safety<br/>[safety.rs]"]
  node_qrgen["QR generation<br/>[qr.rs]"]
end

subgraph group_crypto["Encryption"]
  node_cipher["AES-GCM cipher<br/>[lib.rs]"]
end

node_user(("Desktop user"))
node_phone(("Phone browser"))

node_user -->|"uses"| node_app
node_app -->|"shows"| node_send
node_app -->|"shows"| node_receive
node_app -->|"shows"| node_history
node_app -->|"shows"| node_settings
node_send -->|"starts transfer"| node_transfer_hook
node_receive -->|"starts transfer"| node_transfer_hook
node_transfer_hook -->|"invokes"| node_ipc
node_ipc -->|"invokes commands"| node_commands
node_commands -->|"creates sessions"| node_registry
node_commands -->|"manages server"| node_manager
node_manager -->|"serves routes"| node_http
node_http -->|"looks up sessions"| node_registry
node_http -->|"routes downloads"| node_download
node_http -->|"routes uploads"| node_upload
node_http -->|"serves page"| node_assets
node_phone -->|"requests files"| node_http
node_http -->|"returns transfer data"| node_phone
node_upload -->|"validates files"| node_safety
node_manager -->|"binds LAN address"| node_net
node_commands -->|"discovers network"| node_net
node_commands -->|"checks reachability"| node_reachability
node_commands -->|"checks and repairs"| node_firewall
node_commands -->|"creates QR"| node_qrgen
node_send -->|"shows pairing"| node_qr
node_receive -->|"shows pairing"| node_qr
node_qr -->|"shares session link"| node_phone
node_assets -->|"loads WASM cipher"| node_cipher
node_download -->|"encrypts chunks"| node_cipher
node_upload -->|"authenticates chunks"| node_cipher
node_transfer_hook -->|"records outcome"| node_history
node_settings -->|"configures backend"| node_ipc

click node_app "https://github.com/nacer-eddine05/aerlynk/blob/main/src/App.tsx"
click node_send "https://github.com/nacer-eddine05/aerlynk/blob/main/src/views/SendView.tsx"
click node_receive "https://github.com/nacer-eddine05/aerlynk/blob/main/src/views/ReceiveView.tsx"
click node_qr "https://github.com/nacer-eddine05/aerlynk/blob/main/src/components/QrCard.tsx"
click node_history "https://github.com/nacer-eddine05/aerlynk/blob/main/src/views/HistoryView.tsx"
click node_settings "https://github.com/nacer-eddine05/aerlynk/blob/main/src/views/SettingsView.tsx"
click node_transfer_hook "https://github.com/nacer-eddine05/aerlynk/blob/main/src/hooks/useTransfer.ts"
click node_ipc "https://github.com/nacer-eddine05/aerlynk/blob/main/src/lib/ipc.ts"
click node_commands "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/commands.rs"
click node_registry "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/session.rs"
click node_manager "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server_manager.rs"
click node_http "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server/mod.rs"
click node_download "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server/download.rs"
click node_upload "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server/upload.rs"
click node_assets "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server/assets.rs"
click node_net "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/net.rs"
click node_reachability "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/reachability.rs"
click node_firewall "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/firewall.rs"
click node_safety "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/safety.rs"
click node_qrgen "https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/qr.rs"
click node_cipher "https://github.com/nacer-eddine05/aerlynk/blob/main/crates/aerlynk-crypto/src/lib.rs"

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_send,node_receive,node_qr,node_history,node_settings,node_transfer_hook,node_ipc,node_user,node_phone toneBlue
class node_commands,node_registry,node_manager,node_http,node_download,node_upload,node_assets toneAmber
class node_net,node_reachability,node_firewall,node_safety,node_qrgen toneMint
class node_cipher toneRose
```

## Components

### Desktop experience

- [App navigation](https://github.com/nacer-eddine05/aerlynk/blob/main/src/App.tsx): `src/App.tsx`
- [Send view](https://github.com/nacer-eddine05/aerlynk/blob/main/src/views/SendView.tsx): `src/views/SendView.tsx`
- [Receive view](https://github.com/nacer-eddine05/aerlynk/blob/main/src/views/ReceiveView.tsx): `src/views/ReceiveView.tsx`
- [QR pairing card](https://github.com/nacer-eddine05/aerlynk/blob/main/src/components/QrCard.tsx): `src/components/QrCard.tsx`
- [Transfer history](https://github.com/nacer-eddine05/aerlynk/blob/main/src/views/HistoryView.tsx): `src/views/HistoryView.tsx`
- [Settings view](https://github.com/nacer-eddine05/aerlynk/blob/main/src/views/SettingsView.tsx): `src/views/SettingsView.tsx`
- [Transfer state](https://github.com/nacer-eddine05/aerlynk/blob/main/src/hooks/useTransfer.ts): `src/hooks/useTransfer.ts`
- [Tauri IPC](https://github.com/nacer-eddine05/aerlynk/blob/main/src/lib/ipc.ts): `src/lib/ipc.ts`

### Transfer runtime

- [Session commands](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/commands.rs): `src-tauri/src/commands.rs`
- [Session registry](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/session.rs): `src-tauri/src/session.rs`
- [Server lifecycle](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server_manager.rs): `src-tauri/src/server_manager.rs`
- [Phone HTTP routes](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server/mod.rs): `src-tauri/src/server/mod.rs`
- [Encrypted download](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server/download.rs): `src-tauri/src/server/download.rs`
- [Upload verification](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server/upload.rs): `src-tauri/src/server/upload.rs`
- [Mobile page assets](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/server/assets.rs): `src-tauri/src/server/assets.rs`

### LAN and security

- [LAN discovery](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/net.rs): `src-tauri/src/net.rs`
- [Reachability checks](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/reachability.rs): `src-tauri/src/reachability.rs`
- [Firewall repair](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/firewall.rs): `src-tauri/src/firewall.rs`
- [File safety](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/safety.rs): `src-tauri/src/safety.rs`
- [QR generation](https://github.com/nacer-eddine05/aerlynk/blob/main/src-tauri/src/qr.rs): `src-tauri/src/qr.rs`

### Encryption

- [AES-GCM cipher](https://github.com/nacer-eddine05/aerlynk/blob/main/crates/aerlynk-crypto/src/lib.rs): `crates/aerlynk-crypto/src/lib.rs`

### Other components

- **Desktop user**
- **Phone browser**

## Connections

- Desktop user → App navigation: uses (evidence: `src/App.tsx`)
- App navigation → Send view: shows (evidence: `src/App.tsx`)
- App navigation → Receive view: shows (evidence: `src/App.tsx`)
- App navigation → Transfer history: shows (evidence: `src/App.tsx`)
- App navigation → Settings view: shows (evidence: `src/App.tsx`)
- Send view → Transfer state: starts transfer (evidence: `src/views/SendView.tsx`)
- Receive view → Transfer state: starts transfer (evidence: `src/views/ReceiveView.tsx`)
- Transfer state → Tauri IPC: invokes (evidence: `src/hooks/useTransfer.ts`)
- Tauri IPC → Session commands: invokes commands (evidence: `src/lib/ipc.ts`)
- Session commands → Session registry: creates sessions (evidence: `src-tauri/src/commands.rs`)
- Session commands → Server lifecycle: manages server (evidence: `src-tauri/src/commands.rs`)
- Server lifecycle → Phone HTTP routes: serves routes (evidence: `src-tauri/src/server_manager.rs`)
- Phone HTTP routes → Session registry: looks up sessions (evidence: `src-tauri/src/server/mod.rs`)
- Phone HTTP routes → Encrypted download: routes downloads (evidence: `src-tauri/src/server/mod.rs`)
- Phone HTTP routes → Upload verification: routes uploads (evidence: `src-tauri/src/server/mod.rs`)
- Phone HTTP routes → Mobile page assets: serves page (evidence: `src-tauri/src/server/mod.rs`)
- Phone browser → Phone HTTP routes: requests files (evidence: `README.md`)
- Phone HTTP routes → Phone browser: returns transfer data (evidence: `README.md`)
- Upload verification → File safety: validates files (evidence: `src-tauri/src/server/upload.rs`)
- Server lifecycle → LAN discovery: binds LAN address (evidence: `src-tauri/src/server_manager.rs`)
- Session commands → LAN discovery: discovers network (evidence: `src-tauri/src/commands.rs`)
- Session commands → Reachability checks: checks reachability (evidence: `src-tauri/src/commands.rs`)
- Session commands → Firewall repair: checks and repairs (evidence: `src-tauri/src/commands.rs`)
- Session commands → QR generation: creates QR (evidence: `src-tauri/src/commands.rs`)
- Send view → QR pairing card: shows pairing (evidence: `src/views/SendView.tsx`)
- Receive view → QR pairing card: shows pairing (evidence: `src/views/ReceiveView.tsx`)
- QR pairing card → Phone browser: shares session link (evidence: `README.md`)
- Mobile page assets → AES-GCM cipher: loads WASM cipher (evidence: `README.md`)
- Encrypted download → AES-GCM cipher: encrypts chunks (evidence: `README.md`)
- Upload verification → AES-GCM cipher: authenticates chunks (evidence: `README.md`)
- Transfer state → Transfer history: records outcome
- Settings view → Tauri IPC: configures backend (evidence: `src/views/SettingsView.tsx`)
