countrydialselector #

A lightweight and customizable Flutter package for selecting country phone dial codes using a smooth wheel-style picker.

Built to be simple, flexible, and easy to integrate into any Flutter application.

✨ Features #

• 🎡 Smooth wheel-style country dial code selector
• 🌍 Built-in list of common countries and dial codes
• 🎯 Supports initial country selection
• 🎨 Fully customizable colors (selected, unselected, border)
• 🧩 Strongly typed API using CountryData
• 📦 Lightweight and package-friendly
• 🔌 Supports custom country lists

🚀 Installation #

Add this to your pubspec.yaml:

dependencies:
  countrydialselector: ^0.0.3

Then run:

flutter pub get

📦 Import #

import 'package:countrydialselector/countrydialselector.dart';

🧑‍💻 Basic Usage #

CountryPickerWheel(
  initialCountry: const CountryData(
    name: 'Nigeria',
    dialCode: '+234',
  ),
  selectedTextColor: Colors.green,
  unselectedTextColor: Colors.grey,
  borderColor: Colors.green,
  onSelected: (country) {
    debugPrint('${country.name} → ${country.dialCode}');
  },
)

🎨 Customization #

CountryPickerWheel(
  selectedTextColor: Colors.blue,
  unselectedTextColor: Colors.black45,
  borderColor: Colors.blue,
  height: 240,
  itemExtent: 60,
  onSelected: (country) {},
)

🌍 Using a Custom Country List #

CountryPickerWheel(
  countries: const [
    CountryData(name: 'Ghana', dialCode: '+233'),
    CountryData(name: 'Kenya', dialCode: '+254'),
    CountryData(name: 'Egypt', dialCode: '+20'),
  ],
  onSelected: (country) {
    print(country.dialCode);
  },
)

📚 API Reference #

CountryPickerWheel #

CountryData #

class CountryData {
  final String name;
  final String dialCode;

  const CountryData({
    required this.name,
    required this.dialCode,
  });
}

🤝 Contributing #

Contributions are welcome!

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

📄 License #

This project is licensed under the MIT License.

Author #

Ridwan Abdulazeez

If you find this package useful, please ⭐ the repository and share feedback!