Internet Permission 🌐

A Flutter plugin that automatically adds internet permissions for all platforms!

One command — all platforms configured! ⚡

✨ Features

• 🚀 Automatic setup — Just run: dart run internet_permission:setup
• 📱 Supports 6 platforms — Android, iOS, macOS, Windows, Linux, Web
• 🔒 Safe — Creates backup files before making changes
• ⚡ Fast — Setup completes in seconds
• 🎯 Easy — No additional configuration needed

🚀 Quick Start

1️⃣ Install

flutter pub add internet_permission

2️⃣ Setup (Automatic!)

dart run internet_permission:setup

That's all! ✅

📋 What Does It Add?

📱 Android

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

🍎 iOS

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

💻 macOS

<key>com.apple.security.network.client</key>
<true/>
<key>com.apple.security.network.server</key>
<true/>

🪟 Windows

✅ Default permission (no setup needed)

🐧 Linux

✅ Default permission (no setup needed)

🌐 Web

✅ Default permission (no setup needed)

💻 Usage

Check Internet Connection

import 'package:internet_permission/internet_permission.dart';

final permission = InternetPermission();

// Check if internet is available
bool isConnected = await permission.isConnected();
print('Internet: ${isConnected ? "✅ Connected" : "❌ No connection"}');

// Get connection type
String connectionType = await permission.getConnectionType();
print('Type: $connectionType'); // wifi, mobile, ethernet, vpn, none

Full Example

import 'package:flutter/material.dart';
import 'package:internet_permission/internet_permission.dart';

class InternetChecker extends StatefulWidget {
  @override
  _InternetCheckerState createState() => _InternetCheckerState();
}

class _InternetCheckerState extends State<InternetChecker> {
  final _permission = InternetPermission();
  String _status = 'Checking...';

  @override
  void initState() {
    super.initState();
    _checkInternet();
  }

  Future<void> _checkInternet() async {
    final connected = await _permission.isConnected();
    final type = await _permission.getConnectionType();
    
    setState(() {
      _status = connected 
          ? '✅ Internet: $type' 
          : '❌ No internet';
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        Text(_status, style: TextStyle(fontSize: 20)),
        ElevatedButton(
          onPressed: _checkInternet,
          child: Text('Check Again'),
        ),
      ],
    );
  }
}

📱 Setup Script Output

$ dart run internet_permission:setup

╔═══════════════════════════════════════════════════════╗
║  🚀 Internet Permission Setup v2.0.0                  ║
║  📱 For all platforms                                 ║
╚═══════════════════════════════════════════════════════╝

📁 Project: /path/to/your/project

🔧 Configuring platforms...

📱 Android: ✅ Added (INTERNET, ACCESS_NETWORK_STATE)
🍎 iOS: ✅ Added (NSAppTransportSecurity)
💻 macOS: ✅ Added (network.client, network.server)
🪟 Windows: ✅ Default permissions
🐧 Linux: ✅ Default permissions
🌐 Web: ✅ Default permissions

════════════════════════════════════════════════════════
✅ 6/6 platforms successfully configured!

📋 Next steps:
   1. flutter clean
   2. flutter pub get
   3. flutter run
════════════════════════════════════════════════════════

🎯 API Reference

isConnected() → Future<bool>

Checks if the device has an active internet connection.

bool connected = await InternetPermission().isConnected();

getConnectionType() → Future<String>

Returns the current connection type.

Possible values: wifi, mobile, ethernet, vpn, none

String type = await InternetPermission().getConnectionType();

hasInternetPermission() → Future<bool>

Checks if internet permissions are properly configured.

bool hasPermission = await InternetPermission().hasInternetPermission();

getPlatformVersion() → Future<String?>

Gets the device platform version.

String? version = await InternetPermission().getPlatformVersion();

🔧 Manual Setup (If Needed)

📱 Android (manual)

Edit android/app/src/main/AndroidManifest.xml:

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    
    <application>
        <!-- ... -->
    </application>
</manifest>

🍎 iOS (manual)

Edit ios/Runner/Info.plist:

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

💻 macOS (manual)

Edit macos/Runner/DebugProfile.entitlements and Release.entitlements:

<dict>
    <key>com.apple.security.network.client</key>
    <true/>
    <key>com.apple.security.network.server</key>
    <true/>
</dict>

🧪 Testing

In Example Project

cd example
dart run internet_permission:setup
flutter run

In a New Project

flutter create my_app
cd my_app
flutter pub add internet_permission
dart run internet_permission:setup
flutter run -d macos

⚠️ Important Notes

• Backup Files — The script creates .backup files before making changes
• Repeatable — Safe to run multiple times; skips already configured platforms
• Production — For iOS/macOS, use HTTPS connections in production
• Web — CORS must be configured on your server
• Backward Compatibility — Old command setup_permissions still works

🐛 Troubleshooting

Script Not Working?

flutter clean
flutter pub get
dart run internet_permission:setup

Platform Missing?

Some platforms may not exist in your project by default — this is normal.

Permissions Not Added?

If automatic setup fails, follow the manual setup instructions above.

📦 Version History

2.0.1 — 2025-12-06 🎉

• ✨ NEW: Support for all 6 platforms
• 🚀 Simplified command: dart run internet_permission:setup
• 🎨 Improved terminal UI
• ⚡ Faster execution

1.0.5 — 2025-12-05

• Automatic setup script
• Android & iOS support

🤝 Contributing

Pull requests are welcome! Feel free to contribute to this project.

📄 License

MIT License

🔗 Links

• GitHub Repository
• Report Issues
• Pub.dev Page

👨‍💻 Author

AbubakrFlutter

• 📧 Email: [email protected]
• 🐙 GitHub: @AbubakrFlutter

---

⭐ If you find this plugin useful, please leave a star on GitHub!