flagkit-compose
1.1.3indexedOffers a collection of over 250 beautiful flag icons through Composable functions, allowing customization in various shapes for seamless integration into applications.
9
Stars
—
Used by
dependents
—
Health
/ 100
FlagKit Compose
Beautiful flag icons for Compose Multiplatform and Android. All flags are provided as a Kotlin Multiplatform library through Composable functions.
FlagKit Compose is a port of the original FlagKit to Kotlin.
📸 Screenshots
The screenshots below show the demo app using different Material You themes on Android, and the demo app on iOS
| Android 🇵🇸 | Android 🇮🇹 | Android 🇲🇦 | iOS 🇺🇸 |
|---|---|---|---|
 |  |  |  |
⚙️ Setup 
Add FlagKit dependency to your application:
implementation("eu.acolombo.flagkit:flagkit:1.1.3")
If you are using version catalogs:
[versions]
flagkit = "1.1.3"
# …
[libraries]
flagkit = { group = "eu.acolombo.flagkit", name = "flagkit", version.ref = "flagkit" }
# …
🛠️ Usage
You can use the Flag composable with predefined flags
Flag(
flag = FlagKit.Flag.PS,
shape = RoundedCornerShape(6.dp),
size = DpSize(56.dp, 40.dp),
)
Or simply with a region code string:
Flag(
code = "it",
shape = RoundedCornerShape(6.dp),
size = DpSize(56.dp, 40.dp),
)
There is also an API that closely resembles the original Swift FlagKit API, but it’s not recommended to use since the Compose API is more powerful and flexible:
Flag(
countryCode = "ma",
style = flagkit.FlagStyle.Circle,
)
If needed, you can access the underlying flag assets directly as ImageVectors:
Image(
imageVector = FlagKit.Flag.MA.image,
contentDescription = null,
)
📚 Reference
FlagKit provides over 250 flags. A list of all flags can be found here.
🤝 Contributing
This project rewrites FlagKit for use in Kotlin Multiplatform projects.
If you want to contribute:
– Fork and adapt the project to your needs
– Open a Pull Request for improvements
– Check the issues for bugs or enhancement ideas
📄 License
FlagKit Compose is released under the MIT license. See LICENSE.