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

InternetCheckedScaffold(
  appBar: AppBar(title: Text('My App')),
  body: Center(child: Text('Content')),
)e

Full Example

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Internet Checker Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        useMaterial3: true,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return InternetCheckedScaffold(
      appBar: AppBar(
        title: Text('Internet Checker Demo'),
        centerTitle: true,
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Icon(
              Icons.wifi,
              size: 100,
              color: Colors.green,
            ),
            SizedBox(height: 20),
            Text(
              'Internet is connected!',
              style: TextStyle(
                fontSize: 20,
                fontWeight: FontWeight.bold,
              ),
            ),
            SizedBox(height: 10),
            Text(
              'Try turning off your internet to see the dialog',
              textAlign: TextAlign.center,
              style: TextStyle(color: Colors.grey),
            ),
          ],
        ),
      ),
      // Custom settings
      dialogTitle: 'Connection Lost',
      dialogMessage: 'Unable to connect to the internet. Please check your connection.',
      retryButtonText: 'Try Again',
      checkInterval: Duration(seconds: 3),
    );
  }
}

📱 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

📱 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.2 — 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

👨‍💻 Author

AbubakrFlutter

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

Libraries

internet_permission