{"id":21286611,"url":"https://github.com/moazelsawaf/dash_flags","last_synced_at":"2025-07-11T12:33:25.525Z","repository":{"id":64775426,"uuid":"577704200","full_name":"moazelsawaf/dash_flags","owner":"moazelsawaf","description":"A Flutter package for displaying Countries and Languages flags 🌍","archived":false,"fork":false,"pushed_at":"2023-07-08T03:01:09.000Z","size":14936,"stargazers_count":25,"open_issues_count":3,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-16T03:26:42.036Z","etag":null,"topics":["flags","flutter","pub"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/dash_flags","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moazelsawaf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-13T10:39:00.000Z","updated_at":"2024-10-30T11:00:06.000Z","dependencies_parsed_at":"2024-11-16T03:24:52.004Z","dependency_job_id":"9b483250-6ad7-4e65-8a7f-2d27d1034df1","html_url":"https://github.com/moazelsawaf/dash_flags","commit_stats":{"total_commits":34,"total_committers":1,"mean_commits":34.0,"dds":0.0,"last_synced_commit":"011a6d797595ee8e9b1f610f5e1f37f259e947fd"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moazelsawaf%2Fdash_flags","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moazelsawaf%2Fdash_flags/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moazelsawaf%2Fdash_flags/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moazelsawaf%2Fdash_flags/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moazelsawaf","download_url":"https://codeload.github.com/moazelsawaf/dash_flags/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225720317,"owners_count":17513579,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flags","flutter","pub"],"created_at":"2024-11-21T11:30:35.198Z","updated_at":"2024-11-21T11:31:51.413Z","avatar_url":"https://github.com/moazelsawaf.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://raw.githubusercontent.com/moazelsawaf/dash_flags/main/doc/assets/package_banner.png\" width=\"100%\" alt=\"Dash Flags Banner\" /\u003e\n\u003ch2 align=\"center\"\u003e\n  Dash Flags\n\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://flutter.dev\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Platform-Flutter-02569B?logo=flutter\" alt=\"Platform\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pub.dartlang.org/packages/dash_flags\"\u003e\n    \u003cimg alt=\"Pub Package\" src=\"https://img.shields.io/pub/v/dash_flags.svg?color=blue\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/BSD-3-Clause\"\n  rel=\"ugc\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-BSD_3--Clause-red.svg\" alt=\"License: BSD-3-Clause\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://github.com/moazelsawaf/dash_flags\" rel=\"ugc\"\u003e\u003cimg   src=\"https://img.shields.io/github/languages/code-size/moazelsawaf/dash_flags.svg\" alt=\"GitHub code size in bytes\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/moazelsawaf/dash_flags\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/moazelsawaf/dash_flags.svg?style=flat\u0026logo=github\u0026colorB=ffcc00\u0026label=stars\" alt=\"Star on GitHub\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/moazelsawaf/dash_flags/issues\" rel=\"ugc\"\u003e\u003cimg   src=\"https://img.shields.io/github/issues/moazelsawaf/dash_flags.svg?color=DF1304\" alt=\"GitHub Open Issues\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/moazelsawaf/dash_flags/commits/main\" rel=\"ugc\"\u003e\u003cimg   src=\"https://img.shields.io/github/last-commit/moazelsawaf/dash_flags.svg\" alt=\"GitHub Last Commit Date\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 💡 Overview\n\nA Flutter package for displaying Countries and Languages flags 🌍\n\nThis package provides a set of widgets and enums to display flags of countries and languages inspired by [blade-flags](https://github.com/MohmmedAshraf/blade-flags) package for Laravel by [Mohamed Ashraf](https://github.com/MohmmedAshraf) from Egypt.\n\nThe package uses flags from [TwEmoji Countries \u0026 Languages Flags](https://github.com/twitter/twemoji) by Twitter\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/moazelsawaf/dash_flags/main/doc/assets/animated_example.webp\" width=\"100%\" alt=\"Animated Example\" /\u003e\n\u003cbr\u003e\nThis GIF is taken from the \u003ca href=\"https://github.com/moazelsawaf/dash_flags/tree/main/example\"\u003eExample Project\u003c/a\u003e\n\u003c/p\u003e\n\n## 💻 Usage\n\nImport the package:\n\n```dart\nimport 'package:dash_flags/dash_flags.dart';\n```\n\nDisplay a flag of a country:\n\n```dart\nCountryFlag(\n  country: Country.eg, // OR Country.fromCode('eg')\n  height: 50,\n)\n```\n\nDisplay a flag of a language:\n\n```dart\nLanguageFlag(\n  language: Language.ar, // OR Language.fromCode('ar')\n  height: 50,\n)\n```\n\nDisplay a flag of a timezone:\n\n```dart\nTimezoneFlag(\n  timezone: Timezone.africa_cairo, // OR Timezone.fromString('Africa/Cairo')\n  height: 50,\n)\n```\n\n📘 You can checkout the complete API Reference [here](https://pub.dev/documentation/dash_flags/latest/)\n\n## 📃 Notes\n\n### Countries \u0026 Languages Codes:\n\n- If you have the `Country Code` or `Language Code` as `Strings`, then you can use `Country.fromCode(countryCode)` or `Language.fromCode(languageCode)`.\n- If the the `Country Code` or `Language Code` consists of more than one part, then you will find it separated by an `underscore`, for example: `sh_ac` and `en_au`.\n- If the the `Country Code` or `Language Code` is a reserved keyword in Dart, then you will find it prefixed with `c_` or `l_` respectively, for example: `c_as` and `l_as`.\n- If an unknown `Country Code` or `Language Code` used with `.fromCode(String)` method, an unknown flag would be displayed.\n\n### Timezones Codes:\n\n- The forward slash sign `/` in the name of the timezone is replaced with an underscore `_`.\n- If the `Timezone` contains minus `-` sign, then you will find it replaced with `_minus_`, for example: `US_East_minus_Indiana`, `US_Indiana_minus_Starke`, and `Asia_Ust_minus_Nera`\n- If the `Timezone` contains plus `+` sign, then you will find it replaced `_plus_`, for example: `Etc_GMT_plus_0`, `Etc_GMT_plus_1`, and `Etc_GMT_plus_10`\n- If the `Timezone` is associated with more than one country, then you will find a default enum member for it and other enum members for each country, for example: `Africa_Johannesburg`, `Africa_Johannesburg_ZA`, `Africa_Johannesburg_LS`, and `Africa_Johannesburg_SZ`\n- If you have the `Timezone` as `String` and you want to get the corresponding `Timezone` enum member, then you can use `.fromString()` method.\n- If you want to use the `Timezone` with its original name without the above changes, then use `.fromString()` method, for example: `Timezone.fromString('Africa/Cairo')`\n\n## ✅ Roadmap\n\n- [ ] Add Tests 🧪\n- [ ] Add a simple way to use the raw svg assets 🎨\n- [ ] Make an online Gallery with all the available flags 📘\n- [ ] Add the ability to use the flags from the internet, such as, `CountryFlag.network(...)` 🌐\n- [ ] Add the ability to automatically detect the current `Country` or `Language`, such as, `Country.autoDetect` \u0026 `Language.autoDetect` 🕵🏻‍♂️\n\n## 💖 Laravel Version\n\nIf you are looking for a Laravel Version of this package, check [blade-flags](https://github.com/MohmmedAshraf/blade-flags), the original parent package of this library which that provides a set of flags for all countries and languages by [Mohamed Ashraf](https://github.com/MohmmedAshraf) from Egypt.\n\n\u003ca href=\"https://github.com/MohmmedAshraf/blade-flags\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/MohmmedAshraf/blade-flags/main/art/cover.png\" width=\"100%\" alt=\"Blade Flags Banner\" /\u003e\n\u003c/a\u003e\n\n## 💪🏻 Contribution Guide\n\nI would be happy to have your contributions 💙\n\nIf you find a bug or want a feature, but don't know how to fix/implement it, please fill an [Issue](https://github.com/moazelsawaf/dash_flags/issues).  \nIf you fixed a bug or implemented a feature, please send a [Pull Request](https://github.com/moazelsawaf/dash_flags/pulls).\n\n\u003ca href=\"https://github.com/moazelsawaf/dash_flags/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=moazelsawaf/dash_flags\" /\u003e\n\u003c/a\u003e\n\nMade with [contrib.rocks](https://contrib.rocks).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoazelsawaf%2Fdash_flags","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoazelsawaf%2Fdash_flags","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoazelsawaf%2Fdash_flags/lists"}