A Flutter package by Sanjarbek Fayzullayev for building efficient, scalable, and user-friendly mobile applications with clean architecture and best practices.
Package selection guidance compiled from public package information, community data, and project usage.
A Flutter package that provides a collection of high-quality country flags for use in mobile and web applications. Designed with clean architecture and best practices, it enables developers to efficiently integrate country flags into country picker or country code picker components. The package supports multiple platforms including Android, iOS, Web, macOS, Windows, and Linux, ensuring consistent performance across devices. It is ideal for apps requiring localization, user onboarding, or internationalization features.
Use cases
Internationalized app interfaces
User onboarding with country selection
Phone number input with country flags
Travel and logistics apps
Multi-language support
E-commerce checkout flows
Key features
Pre-built, scalable flag assets
Cross-platform compatibility
Clean, maintainable code structure
Easy integration with country pickers
Optimized for performance
Supports dark mode
Suitable for
Developers building global apps
Teams using clean architecture
Apps requiring country selection
Frontend-focused Flutter projects
Projects targeting multiple operating systems
Considerations
Requires manual flag asset updates for new countries
Limited customization options for flag styling
No built-in country name translation
Dependent on external source for flag images
Not suitable for offline-only applications without caching
May increase bundle size slightly with full flag set
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
country_flags_pro is a Flutter package that allows you to display country flags in SVG format. This package lets you easily fetch and display flags based on country codes.
🚀 Why Use country_flags_pro?
✔ Works Offline – No internet required! 🌍
✔ Fast & Lightweight – Flags load instantly. ⚡
✔ Optimized SVG – High-quality flag images. 🏴
Installation
To use this package, add the following dependencies to your pubspec.yaml file:
import'package:flutter/material.dart';
import'package:flutter/material.dart';
import'package:country_flags_pro/country_flags_pro.dart';
voidmain() {
runApp(constMyApp());
}
classMyAppextendsStatelessWidget{
constMyApp({super.key});
// This widget is the root of your application.@overrideWidgetbuild(BuildContext context) {
returnMaterialApp(
title: 'Flutter Demo',
theme: ThemeData(
// This is the theme of your application.// TRY THIS: Try running your application with "flutter run". You'll see// the application has a purple toolbar. Then, without quitting the app,// try changing the seedColor in the colorScheme below to Colors.green// and then invoke "hot reload" (save your changes or press the "hot// reload" button in a Flutter-supported IDE, or press "r" if you used// the command line to start the app).//// Notice that the counter didn't reset back to zero; the application// state is not lost during the reload. To reset the state, use hot// restart instead.//// This works for code too, not just values: Most code changes can be// tested with just a hot reload.
colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
useMaterial3: true,
),
home: HomePage(),
);
}
}
classHomePageextendsStatelessWidget{
var list = CountryFlagsPro.validCountryCodes;
staticIterable<String> mapCountryCodeName =
CountryFlagsPro.countryCodeAndName.values;
staticList<String> listName = mapCountryCodeName.toList();
@overrideWidgetbuild(BuildContext context) {
returnScaffold(
body: GridView.builder(
gridDelegate:
SliverGridDelegateWithFixedCrossAxisCount(crossAxisCount: 2),
itemCount: list.length,
itemBuilder: (context, index) {
returnPadding(
padding: EdgeInsets.all(20),
child: CountryFlagsPro.getFlag(list[index], // Country code
width: 100.0, // Flag width
height: 400.0, // Flag height
fit: BoxFit.cover, // Flag fit
borderRadius: BorderRadius.circular(400), //Flag border radius
borderColor: Colors.black87, //Flag border color
borderWidth: 6//Flag border width
),
);
},
),
);
}
}
🌍 Platform Support
Platform
Supported
✅ Android
✅ Yes
✅ iOS
✅ Yes
✅ Web
✅ Yes
✅ Windows
✅ Yes
✅ macOS
✅ Yes
✅ Linux
✅ Yes
🌍 Available Flags
This package supports all official country flags in SVG format. Example: