net-bridge/docs/desktop-migration.md

Future Desktop Client Migration Plan

Shared Core

The Rust crates are already structured so desktop clients can reuse:

• VSHP frame parsing and encoding.
• Peer/session models.
• NAT, MTU, DNS, and flow-control logic where applicable.
• Transport abstractions.

Desktop-Specific Layers

Windows:

• Wintun adapter.
• Windows service.
• MSI/MSIX installer.
• Credential Manager key storage.

Linux:

• TUN device.
• systemd user/system service.
• NetworkManager integration where available.
• Secret Service key storage.

macOS:

• utun interface.
• launchd service.
• Keychain key storage.
• Notarized app bundle.

Product Migration Steps

1. Keep clients/desktop as the CLI bring-up tool.
2. Add OS-specific virtual NIC crates under clients/desktop/src/platform.
3. Add installers once USB IPv4 forwarding is stable.
4. Add tray UI after service lifecycle is reliable.
5. Split GUI from service so crashes do not drop the tunnel.