How zep4yrs/lannook works
LanNook is a desktop-hosted, local-network file-transfer product with a browser-based mobile client. The main workflow is: the desktop starts its LAN service and shares a QR/address or pairing PIN; a phone connects and may require desktop approval; either side sends files; the host handles transfer and local persistence; both clients see live status and transfer history. The graph includes device discovery, resumable transfer, diagnostics, settings, and native desktop controls. Backend details are only partly sampled, so some documented links are shown without source-level verification.
Main entry points: DesktopLayout.vue Desktop interface · index.ts App routes · mod.rs LAN service · handlers.rs HTTP handlers
Components 25
Client experience
- Desktop interface
src/layouts/DesktopLayout.vue - Mobile interface
src/layouts/MobileLayout.vue - App routes
src/router/index.ts - Connection home
src/pages/HomePage.vue - Mobile sending
src/pages/MobileSendPage.vue - Transfer center
src/pages/TransfersPage.vue
Session coordination
- Service state
src/stores/app.ts - Devices and approval
src/stores/devices.ts - Mobile session
src/stores/mobileSession.ts - Transfer state
src/stores/transfers.ts - Preferences
src/stores/settings.ts
LAN runtime
- HTTP client
src/services/api.ts - Live events
src/services/websocket.ts - LAN service
src-tauri/src/server/mod.rs - HTTP handlers
src-tauri/src/server/handlers.rs - Network discovery
src-tauri/src/discovery/mod.rs - WebSocket server
src-tauri/src/server/ws.rs
Transfer and storage
- Transfer engine
src-tauri/src/transfer/mod.rs - Chunk downloads
src-tauri/src/server/download.rs - Local records
src-tauri/src/storage/mod.rs - Browser upload
src/services/upload.ts
Desktop integration
- Tauri bridge
src/services/tauri.ts - Native commands
src-tauri/src/commands/server_cmd.rs
Other components
- Desktop user
- Phone user
Connections 33
- Desktop user → Desktop interface: uses
README.md - Phone user → Mobile interface: opens in browser
README.md - App routes → Desktop interface: routes to
src/router/index.ts - App routes → Mobile interface: routes to
src/router/index.ts - App routes → Connection home: routes to
src/router/index.ts - App routes → Mobile sending: routes to
src/router/index.ts - App routes → Transfer center: routes to
src/router/index.ts - Desktop interface → Service state: uses
src/layouts/DesktopLayout.vue - Desktop interface → Devices and approval: uses
src/layouts/DesktopLayout.vue - Desktop interface → Transfer state: uses
src/layouts/DesktopLayout.vue - Connection home → Service state: reads service state
src/pages/HomePage.vue - Connection home → Devices and approval: reads devices
src/pages/HomePage.vue - Transfer center → Transfer state: reads tasks
src/pages/TransfersPage.vue - Mobile sending → Mobile session: uses session
- Service state → Tauri bridge: starts service
src/stores/app.ts - Tauri bridge → Native commands: invokes commands
- Native commands → LAN service: controls service
- LAN service → HTTP handlers: registers handlers
src-tauri/src/server/mod.rs - LAN service → WebSocket server: registers events
src-tauri/src/server/mod.rs - LAN service → Network discovery: uses discovery
src-tauri/src/server/mod.rs - Mobile sending → Browser upload: sends files
- Browser upload → HTTP client: uploads chunks
- HTTP client → HTTP handlers: HTTP requests
README.md - Live events → WebSocket server: exchanges events
README.md - Devices and approval → Live events: receives updates
src/stores/devices.ts - Transfer state → Live events: receives updates
src/stores/transfers.ts - HTTP handlers → Transfer engine: delegates transfer
src-tauri/src/server/handlers.rs - HTTP handlers → Local records: reads records
src-tauri/src/server/handlers.rs - Chunk downloads → Local records: resumes chunks
- Transfer engine → Local records: persists transfer state
- Preferences → Tauri bridge: loads and saves settings
src/stores/settings.ts - Desktop interface → Tauri bridge: uses desktop features
- Phone user → Desktop user: requests device access
README.md