How dododook/flowz works
FlowZ is a cross-platform sing-box proxy client. Users add servers directly or import subscriptions, configure routing and proxy mode, then enable the proxy; the desktop UI sends requests to the Electron main process, which manages the sing-box runtime and operating-system integration. Separate product branches handle rule resources, mesh networking, live connection/statistics views, updates, and diagnostics. Relationships for unsampled subsystems are included only where the README documents the capability; the graph does not imply unverified internal call chains.
Main entry points: ProxyManager.ts Proxy manager · api-client.ts Renderer API · handlers IPC handlers · index.ts Electron main
Components 21
Desktop interface
- App and pages
src/renderer/App.tsx - Renderer API
src/renderer/ipc/api-client.ts
Main-process control
- Electron main
src/main/index.ts - IPC handlers
src/main/ipc/handlers - Configuration
src/main/services/ConfigManager.ts
Routing and nodes
- Server import
src/main/services/ProtocolParser.ts - Subscriptions
src/main/services/SubscriptionService.ts - Routing rules
src/main/services/RuleResourceManager.ts - Mesh services
src/main/services/WarpService.ts - Rule resources
src/main/services/RuleResourceManager.ts
Proxy runtime
- Proxy manager
src/main/services/ProxyManager.ts - sing-box core
- System proxy
src/main/services/SystemProxyManager.ts - System DNS
src/main/services/SystemDnsManager.ts - Privileged helpers
src/main/services/HelperManager.ts
Operations and insight
- Live statistics
src/main/workers/stats-worker.ts - Logs
src/main/services/LogManager.ts - Diagnostics
src/main/services/DiagnosticService.ts - Application updates
src/main/services/UpdateService.ts - Core and assets
src/main/services/ResourceManager.ts
Other components
- User
Connections 23
- User → App and pages: configures
README.md - App and pages → Renderer API: requests
src/renderer/App.tsx - Renderer API → IPC handlers: invokes
src/renderer/ipc/api-client.ts - IPC handlers → Configuration: reads and saves
- IPC handlers → Proxy manager: controls
src/main/ipc/handlers/helper-handlers.ts - Electron main → Proxy manager: manages
src/main/index.ts - Proxy manager → sing-box core: starts and controls
README.md - Proxy manager → System proxy: sets system proxy
src/main/services/ProxyManager.ts - Proxy manager → System DNS: manages DNS
src/main/services/ProxyManager.ts - Proxy manager → Privileged helpers: uses helper
src/main/services/ProxyManager.ts - User → Server import: adds servers
README.md - User → Subscriptions: imports subscriptions
README.md - Subscriptions → Configuration: updates nodes
- User → Routing rules: configures routing
README.md - User → Rule resources: manages rule sets
README.md - User → Mesh services: sets up mesh
README.md - sing-box core → Live statistics: provides runtime data
src/main/workers/stats-worker.ts - Renderer API → Live statistics: requests statistics
- User → Logs: views logs
README.md - User → Diagnostics: exports report
README.md - User → Application updates: updates app
README.md - Electron main → Core and assets: manages assets
src/main/index.ts - sing-box core → Rule resources: loads rule sets
README.md