🌍 World Picker #

A comprehensive Flutter package for country selection with detailed metadata including flags, currencies, phone codes, zip code formats, languages, and timezones.

✨ Features #

• 🏁 Complete Country Data: All 195 UN-recognized countries
• 🎌 High-Quality Flags: SVG flags for all countries
• 💰 Currency Information: Names, codes, and symbols
• 📞 Phone Codes: International dialing codes
• 🗣️ Languages: Official languages with native names
• ⏰ Timezones: Complete timezone information
• 📮 ZIP Codes: Postal code formats and patterns
• 🌍 Regional Organization: Countries organized by continents
• 🔍 Search & Filter: Powerful search functionality
• 🎨 Customizable UI: Flexible theming and styling options
• 📱 Phone Number Field: Input and validate phone numbers with country picker integration

📦 Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  world_picker: ^1.0.0

Then run:

flutter pub get

Quick Start #

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

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  Country? selectedCountry;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: WorldPickerIcon(
          onSelect: (country) {
            setState(() {
              selectedCountry = country;
            });
          },
          selectedCountry: selectedCountry,
        ),
      ),
    );
  }
}

📖 API Reference #

WorldPickerIcon #

A widget that displays a country selector with flag and customizable display options.

Example Usage

WorldPickerIcon(
  onSelect: (country) {
    print('Selected: ${country.name}');
  },
  selectedCountry: WorldPickerService.fromIsoCode('US'),
  showIsoCode: true,
  showName: true,
  showDialCode: true,
  size: 32.0,
  options: WorldPickerOptions(
    placeholder: 'Search countries...',
    showCurrencyCode: true,
    showDialCode: true,
    favoriteCountries: ['US', 'BR', 'IN'],
  ),
)

Screen Recordings #

WorldPickerIcon Demo

https://github.com/user-attachments/assets/23a378ab-5fb1-4077-bd96-ce69bda1cac1

WorldPickerOptions #

Configuration options for customizing the country picker dialog.

Country Model #

The Country class contains comprehensive information about each country:

class Country {
  final String name;              // Country name (e.g., "United States")
  final String isoCode;           // ISO 3166-1 alpha-2 code (e.g., "US")
  final Continent continent;      // Continent information
  final List<Language> languages; // Official languages
  final List<Currency> currencies; // Currencies used
  final String dialCode;          // International dialing code (e.g., "+1")
  final String phonePattern;     // Phone number regex pattern
  final String zipCodePattern;   // ZIP/postal code regex pattern
  final List<String> timezones;  // Timezone identifiers
  final String flagAssetPath;    // Path to flag asset
}

WorldPickerService #

Utility service for country operations:

// Get country by ISO code
Country? country = WorldPickerService.fromIsoCode('BR');

// Get all countries
List<Country> allCountries = WorldPickerService.continents();

// Get countries by continent
List<Country> asianCountries = WorldPickerService.fromContinentCode('AS');

// Search countries
List<Country> results = WorldPickerService.fromCountryName('united');

Phone Number Field Quick Start #

import 'package:world_picker/world_picker.dart';

WorldPickerPhoneNumberField(
  onPhoneNumberChanged: (phoneNumber) {
    print('Number: \${phoneNumber.phoneNumber}, Country: \${phoneNumber.isoCode}');
  },
  options: WorldPickerOptions(
    placeholder: 'Enter your number...',
    showDialCode: true,
  ),
  decoration: InputDecoration(
    labelText: 'Phone',
    border: OutlineInputBorder(),
  ),
)

🌍 Supported Countries #

This package includes all 195 UN-recognized countries organized by continents:

• Africa: 54 countries
• Asia: 49 countries
• Europe: 44 countries
• North America: 23 countries
• Oceania: 14 countries
• South America: 12 countries
• Caribbean: 13 countries
• Central America: 7 countries

🎨 Customization #

Custom Search Input #

WorldPickerIcon(
  onSelect: (country) => {},
  options: WorldPickerOptions(
    placeholder: 'Find your country...',
    inputDecoration: InputDecoration(
      labelText: 'Country Selection',
      border: OutlineInputBorder(
        borderRadius: BorderRadius.circular(12.0),
      ),
      prefixIcon: Icon(Icons.search),
      suffixIcon: Icon(Icons.public),
    ),
  ),
)

Display Customization #

WorldPickerIcon(
  onSelect: (country) => {},
  showIsoCode: true,
  showName: true,
  showDialCode: true,
  showCurrencyCode: false,
  size: 40.0,
)

📱 Example App #

Check out the /example directory for a complete implementation showing:

• Country selection with search
• Detailed country information display
• Custom styling and theming
• All available features in action

🤝 Contributing #

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Development Setup #

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License #

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

🙏 Acknowledgments #

• Country data sourced from official UN records
• Flag icons provided as SVG for crisp display at any size
• Timezone data based on IANA Time Zone Database

Made with ❤️ for the Flutter community