DEV Community

Cover image for 🚀 Introducing flutter_v2ray_client: Your Ultimate Flutter VPN Solution!
Amir Ziari
Amir Ziari

Posted on • Originally published at github.com

🚀 Introducing flutter_v2ray_client: Your Ultimate Flutter VPN Solution!

#flutter #vpn #v2ray #proxy

Hey Flutter fam! 👋 I'm absolutely thrilled to share my very first open-source package with you all! After months of hard work, I'm excited to introduce flutter_v2ray_client - a powerful Flutter plugin that brings the full power of V2Ray/Xray to your mobile applications! 🌟

🎯 What Makes This Special?

As someone who's passionate about privacy and performance, I wanted to create something that would make it incredibly easy for Flutter developers to integrate robust VPN and proxy functionality into their apps. This isn't just another wrapper - it's a thoughtfully designed, modern Flutter plugin with a clean API that you'll actually enjoy using! 💜

✨ Key Features That'll Blow Your Mind

🔐 Dual Mode Support

  • VPN Mode: Full system-level tunneling for complete privacy protection
  • Proxy Mode: Lightweight proxy-only connections for specific app traffic

🌐 Multi-Protocol Powerhouse

Seamlessly works with:

  • VMess - The classic choice for speed and reliability
  • VLess - Lightweight and efficient modern protocol
  • Trojan - Stealthy connections that blend with normal traffic
  • Socks - Universal proxy protocol support
  • ShadowSocks - Popular choice for censorship resistance

📊 Real-Time Monitoring Dashboard

Get live updates on:

  • Connection status and health
  • Upload/download speeds
  • Total traffic usage
  • Connection duration
  • Server response times

🎛️ Flexible Configuration 

// Parse any V2Ray sharing link effortlessly
V2RayURL parser = V2ray.parseFromURL("your_v2ray_link_here");

// Customize everything to your needs
parser.inbound['port'] = 10890;
parser.log['loglevel'] = 'info';
parser.dns = {"servers": ["1.1.1.1"]};
Enter fullscreen mode Exit fullscreen mode

🛡️ Smart Traffic Management

  • App Exclusion: Choose specific apps to bypass VPN traffic
  • LAN Bypass: Keep local network traffic flowing normally
  • Socket Protection: Prevents connection loops and ensures stability

🚀 Getting Started (It's Super Easy!)

1️⃣ Add to Your Project 

flutter pub add flutter_v2ray_client
Enter fullscreen mode Exit fullscreen mode

2️⃣ Basic Implementation 

import 'package:flutter_v2ray_client/flutter_v2ray.dart';

final V2ray v2ray = V2ray(
    onStatusChanged: (status) {
        print('Connection status: ${status.state}');
    },
);

// Initialize and connect
await v2ray.initialize(
    notificationIconResourceType: "mipmap",
    notificationIconResourceName: "ic_launcher",
);

V2RayURL parser = V2ray.parseFromURL("your_v2ray_link_here");

if (await v2ray.requestPermission()) {
    await v2ray.startV2Ray(
        remark: parser.remark,
        config: parser.getFullConfiguration(),
        proxyOnly: false,
    );
}
Enter fullscreen mode Exit fullscreen mode

🎨 Real-World Usage

Imagine building apps like:

  • Privacy-First Browsers 🛡️
  • Secure Messaging Apps 💬
  • Streaming Media Players 🎥
  • Corporate VPN Solutions 🏢
  • Developer Tools ⚙️

🌟 What's Under the Hood?

  • Android-First: Built with Xray 25.9.11 core for maximum performance
  • Modern Flutter: Compatible with Flutter 3.16.0+ and Dart 3.1.0+
  • Clean Architecture: Platform interface ready for iOS, Windows, Linux, macOS expansion
  • Google Play Ready: Full Android 16 KB page size support
  • Open Source: MIT licensed for maximum community benefit

🎯 Perfect For

✅ App Developers wanting to add VPN functionality
✅ Privacy Advocates building secure applications
✅ Network Engineers creating custom proxy solutions
✅ Students learning Flutter plugin development
✅ Companies needing enterprise VPN solutions

🛣️ Roadmap & Future Plans

I'm committed to making this the best Flutter VPN solution out there! Here's what's coming:

🚀 Performance Boost

  • Integration with hev-socks5-tunnel for blazing-fast speeds
  • Enhanced connection stability and resource efficiency

🌍 Multi-Platform Expansion

  • iOS Support (community donations welcome!)
  • Windows, Linux, macOS desktop versions
  • Cross-platform consistency

⚡ Advanced Features

  • Traffic routing and filtering
  • Custom UI components
  • Extended protocol support

💝 Community Love

This project thrives on community contributions! Whether you're:

  • 🐛 Reporting bugs or suggesting improvements
  • 💻 Contributing code to new features
  • 📚 Improving documentation
  • 🎨 Creating example apps
  • 🌟 Spreading the word

Every contribution makes a difference! Check out our Contributing Guide to get started.

👨‍💻 About Me

Hey there! I'm Amir, a passionate Full Stack developer who loves creating tools that make privacy and security accessible to everyone. This is my first major open-source contribution, and I'm incredibly excited to share it with the community!

📱 Portfolio: Check out more of my work at Amir Ziari Portfolio

🎉 Final Thoughts

Building flutter_v2ray_client has been an incredible journey of learning and growth. I'm so grateful to the Flutter community for the amazing ecosystem that made this possible, and I can't wait to see what you'll build with it!

Ready to supercharge your Flutter apps with VPN capabilities? Give flutter_v2ray_client a try today! 🚀

Tags: #Flutter #VPN #V2Ray #XRay #Android #Proxy #Dart #OpenSource #Privacy #MobileDevelopment

Links:

Have questions? Found a bug? Want to contribute? I'd love to hear from you! Drop a comment below or reach out on GitHub. Let's build something amazing together! 🎯

Top comments (0)