Flutter Offline Detection #

A production-ready Flutter package to detect REAL internet connectivity using native APIs (ConnectivityManager.NetworkCallback on Android, NWPathMonitor on iOS).

Unlike other packages that only check for "network connection" (e.g. Wi-Fi connected but no internet), this package verifies actual internet reachability.

Features #

• 🚀 Real Internet Detection: Validates if the network actually has internet access.
• ⚡ Native Implementation: Uses NetworkCallback (Android) and NWPathMonitor (iOS).
• 🔋 Battery Efficient: No polling. Event-based updates only when status changes.
• 🛡️ Platform Support: Android 21+, iOS 12+.

Why detection is better than connectivity_plus? #

Installation #

Add to your pubspec.yaml:

dependencies:
  flutter_offline_detection:
    path: . # If local, otherwise usage from pub.dev

Usage #

import 'package:flutter_offline_detection/flutter_offline_detection.dart';

// Check once
final status = await FlutterOfflineDetection.checkNow();
if (status == InternetStatus.connected) {
  print("We have internet!");
}

// Listen for changes
FlutterOfflineDetection.onStatusChange.listen((status) {
  print("Status changed to: $status");
});

Platform Configuration #

Android #

Works out of the box for Android 5.0 (API 21) +. Internally uses ConnectivityManager.registerNetworkCallback and checks for NET_CAPABILITY_VALIDATED (on Android M+) to ensure the connection is valid.

Permissions: The plugin adds ACCESS_NETWORK_STATE automatically.

iOS #

Works out of the box for iOS 12+. Internally uses NWPathMonitor to check if the path status is .satisfied.

License #

MIT