Nigerian Network Detector #

A lightweight, zero-dependency Dart package for detecting the mobile network carrier of Nigerian phone numbers.

Features #

• 🔍 Network Detection — Identify MTN, Airtel, Glo, and 9mobile from a phone number
• 📱 Format Normalisation — Automatically normalises local, international (+234), and raw international formats
• ✅ Validation — Verify whether a string is a valid Nigerian mobile number
• 🌍 International Formatting — Convert any valid input to E.164-like international format
• 🪶 Zero Dependencies — Pure Dart with no external runtime packages

Supported Formats #

Installation #

Add to your pubspec.yaml:

dependencies:
  nigerian_network_detector: ^1.0.0

Then run:

dart pub get

Usage #

Full Detection #

import 'package:nigerian_network_detector/nigerian_network_detector.dart';

void main() {
  final result = NigerianNetworkDetector.detect('08031234567');

  if (result.isValid) {
    print(result.network);       // MTN
    print(result.normalized);    // 08031234567
    print(result.international); // +2348031234567
    print(result.prefix);        // 0803
  } else {
    print(result.error);         // Error description
  }
}

Quick Validation #

NigerianNetworkDetector.isValid('08031234567');  // true
NigerianNetworkDetector.isValid('1234567890');   // false

Get Network Directly #

final network = NigerianNetworkDetector.networkOf('09091234567');
print(network); // 9mobile

Format Conversion #

// International → Local
NigerianNetworkDetector.normalize('+2348031234567');
// '08031234567'

// Local → International
NigerianNetworkDetector.toInternational('08031234567');
// '+2348031234567'

Supported Networks & Prefixes #

API Reference #

Contributing #

Contributions are welcome! Please open an issue or submit a pull request.

License #

This project is licensed under the MIT License — see the LICENSE file for details.