Skip to content
pubscout

flutter_vless

1.1.7, released 2 weeks ago by tfox.dev

Cross-platform Xray/V2Ray VPN and proxy plugin for Flutter apps.

WASM-ready
$ flutter pub add flutter_vless
Source repository

What it does

Allows Flutter apps to build cross-platform VPN and proxy clients supporting protocols like VLESS, VMess, Trojan, Shadowsocks, and Hysteria2. It parses share links, subscriptions, Clash YAML, and sing-box JSON, running native VPN or proxy modes across Android, iOS, macOS, and Windows.

AI-written summary of version 1.1.7, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to build a custom VPN client in Flutter using Xray/V2Ray protocols.
  • You need to import proxy and VPN configurations from share links, subscriptions, or Clash YAML.

Skip it when

  • You only need standard REST or GraphQL API requests over HTTP.
  • You want a pure Dart networking library without native platform binaries and VPN permissions.

Strengths

  • Supports multiple protocols including VLESS Reality, VMess, Trojan, Shadowsocks, and Hysteria2.
  • Works across Android, iOS, macOS, and Windows with proxy and VPN tunnel modes.
  • Parses share links, subscriptions, raw Xray JSON, Clash YAML, and sing-box JSON.

Weaknesses

  • Requires platform-specific setup such as native runtime files, entitlements, App Groups, and network extensions.
  • VPN tunnel mode requires administrative privileges on Windows and signed builds on Apple platforms.

Setup

Kind
Plugin (native code)
Effort
High
Code generation
No
Direct dependencies
5

Requires platform guides for Android (VpnService), iOS/macOS (Network Extension, App Groups, SwiftPM metadata, and code signing), and Windows (runtime helper files and admin privileges for tunnel mode).

final flutterVless = FlutterVless();
final parsed = FlutterVless.parse(shareLink);
await flutterVless.startVless(remark: parsed.remark, config: parsed.getFullConfiguration());

Alternatives

Packages that do the same job and could replace flutter_vless.

Works with

Packages commonly used together with flutter_vless: ones it builds on, ones built on it, and its own family.