country_city_kit

A lightweight and easy-to-use Flutter package for accessing countries, states, and cities data.

---

Preview

---

Screenshots

Select Country	Select State / City	Selected Result

---

✨ Features

• 🌍 Get all countries
• 🏙️ Get states by country
• 📍 Get cities by state
• ⚡ Lightweight and fast
• 🧩 Simple API
• 💙 Flutter friendly
• 🚫 No external dependencies

---

🚀 Installation

Add this to your pubspec.yaml:

dependencies:
  country_city_kit: ^1.0.0

Then run:

flutter pub get

---

📦 Import

import 'package:country_city_kit/country_city_kit.dart';

---

🛠️ Usage

Get All Countries

final countries = await CountryCityKit.getCountries();

print(countries);

---

Get States by Country

final states = await CountryCityKit.getStates('Bangladesh');

print(states);

---

Get Cities by State

final cities = await CountryCityKit.getCities(
  country: 'Bangladesh',
  state: 'Dhaka',
);

print(cities);

---

📋 Example Output

[Bangladesh, India, Pakistan]

---

💻 Platform Support

Platform	Supported
Android	✅
iOS	✅
Web	✅
Windows	✅
macOS	✅
Linux	✅

---

🗺️ Roadmap

• Country flag support
• ISO code support
• Phone code support
• Search functionality
• Country picker widgets
• Localization support

---

🤝 Contributing

Contributions are welcome!

Feel free to open issues or submit pull requests on GitHub.

---

📄 License

This package is licensed under the MIT License.