{"id":19311965,"url":"https://github.com/yummygum/flagpack-core","last_synced_at":"2025-05-15T10:07:13.591Z","repository":{"id":40706420,"uuid":"185571575","full_name":"Yummygum/flagpack-core","owner":"Yummygum","description":"Flagpack contains 250+ flag icons to easily use within your code project.","archived":false,"fork":false,"pushed_at":"2024-06-16T07:40:45.000Z","size":14251,"stargazers_count":602,"open_issues_count":35,"forks_count":131,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-05-15T10:06:35.197Z","etag":null,"topics":["flagpack","flags","icons","npm","svg"],"latest_commit_sha":null,"homepage":"https://flagpack.xyz","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Yummygum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"github":"yummygum","custom":["https://www.paypal.com/paypalme/yummygum"]}},"created_at":"2019-05-08T09:09:52.000Z","updated_at":"2025-04-30T17:27:48.000Z","dependencies_parsed_at":"2024-06-18T13:47:47.742Z","dependency_job_id":"bbd63101-c8e2-4bd1-bacd-289e3f2b34ee","html_url":"https://github.com/Yummygum/flagpack-core","commit_stats":{"total_commits":120,"total_committers":10,"mean_commits":12.0,"dds":0.5166666666666666,"last_synced_commit":"358034b43143b81e4ad0b046a693208501940c9f"},"previous_names":["yummygum/flag-pack-core"],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yummygum%2Fflagpack-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yummygum%2Fflagpack-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yummygum%2Fflagpack-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yummygum%2Fflagpack-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Yummygum","download_url":"https://codeload.github.com/Yummygum/flagpack-core/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254319720,"owners_count":22051073,"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":["flagpack","flags","icons","npm","svg"],"created_at":"2024-11-10T00:31:43.087Z","updated_at":"2025-05-15T10:07:08.571Z","avatar_url":"https://github.com/Yummygum.png","language":"TypeScript","funding_links":["https://github.com/sponsors/yummygum","https://www.paypal.com/paypalme/yummygum","https://github.com/sponsors/Yummygum"],"categories":[],"sub_categories":[],"readme":"# Flagpack\n\nFlagpack contains 250+ flag icons to easily use within your code project. Flagpack is an open source project and available for JavaScript frameworks/libraries React, Vue and Svelte.\n\n![Flagpack. 250+ easily implementable flag icons to use in your design or code project. Open Source. Available for Sketch, Figma, Angular, Vue, and React. [www.flagpack.xyz](http://www.flagpack.xyz). Made with love by Yummygum. Graphic showing a list with the flags of Argentina, Croatia, Estonia, Kenia, Netherlands, and Scotland.](https://flagpack.xyz/meta-image.png)\n\n[View documentation on flagpack.xyz](https://flagpack.xyz/docs/)\n\n## flagpack-core\n\u003cp\u003e\n  \u003ca href=\"https://www.npmjs.com/package/flagpack-core\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/v/flagpack-core.svg?style=flat\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/flagpack-core\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/dt/flagpack-core.svg?style=flat\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/sponsors/Yummygum\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Support-♥-E94AAA\"  /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://twitter.com/flagpack\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/twitter/follow/flagpack.svg?style=social\u0026label=follow\"  /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nFlagpack core has been created to provide and share the flag assets used in [Flagpack](https://flagpack.xyz/). It also provides some logic to help with building on top of this package. For example, it can also be used to map over the `countryCodeList.json` to display all flags.\n\n\n## Installation\nFlagpack is available as a ready-to-use package through our framework packages. See the repo for more information about installing those.\n- [Flagpack for React](https://github.com/Yummygum/react-flagpack)\n- [Flagpack for Vue](https://github.com/Yummygum/vue-flagpack)\n- [Flagpack for Svelte](https://github.com/Yummygum/svelte-flagpack)\n\n### Installing flagpack-core\nYou can setup flagpack-core by cloning the repo through `git clone`\n\n```bash\n$ git clone https://github.com/Yummygum/flagpack-core\n```\n\n### Example of running a test environment\nNormally if you'll use any component the core will be automatically installed as peer dependency. If you want to test the core, you'll need to install one of the components and install the core as local module.\n\n```bash\n$ git clone https://github.com/Yummygum/flagpack-core\n$ cd ./flagpack-core\n$ npm link\n```\n\nThen move into your test project and install the local dependency by using `npm link`\n\n```bash\n$ npm link flagpack-core\n``` \n\nFor more information on the use of installing a local package, we'd recommend checking [the npm link documentation](https://docs.npmjs.com/cli/v7/commands/npm-link).\n\n## Use\n\nWith the release of Flagpack [`2.0.0`](https://github.com/Yummygum/flagpack-core/releases/tag/v2.0.0), Flagpack no longer serves all of the images in a single file. This is done to only serve the flags it requires, in other words: to preform 'treeshaking'. You'll have to import each flag separately, using the `flags` directory in `flagpack-core`. For an example to how to set this up dynamically, check out our [`react-flagpack` package](https://github.com/Yummygum/react-flagpack).  \n\n## Flag Policy\n\nWhich flags should be included is an ongoing point of discussion within a project such as Flagpack. To provide some form of consistency, as of the 2.0 release Flagpack will be using the ISO 3166 standard as our baseline for our flag selection. In other words: Flagpack will provide flags for all ISO 3166 countries. \n\n### Exceptions\n\nAs ISO 3166 specifies countries, we ran into two exceptions to our rule. Luckily 3166 has different subsets to provide us with alpha-2 codes for these specific exceptions.\n\n#### BES Islands\n\nThe Islands of Saba, Saint Eustasius and Bonaire are their own entity within the ISO standard, but don't have a shared flag. We chose to include them individually under the alpha-2 codes `BQ-SA`, `BQ-BO` and `BQ-SE` respectively. These codes are specified in [ISO 3166-2:BQ](https://nl.wikipedia.org/wiki/ISO_3166-2:BQ).\n\n#### Countries within The United Kingdom\n\nTo provide some clear distinction within the different countries within The United Kingdom, we've opted to included the flags of England, Scotland, Wales and Northern Ireland in Flagpack, along side the flag of the UK itself (alpha-2: `GB-UKM`). They use the alpha-2 codes of `GB-ENG`, `GB-SCT`, `GB-WLS` and `GB-NIR` respectively. These can be found in the [ISO 3166-2:GB](https://nl.wikipedia.org/wiki/ISO_3166-2:GB).\n\n### Future additions\n\nWith these changes also comes a bit of a change in suggested additions to Flagpack. If want you to suggest a flag to add to Flagpack, please keep the following things in mind:\n\n- Flags in Flagpack must represent a country or location.\n- Flags in Flagpack must be represented in the ISO 3166 standard or a subset thereof.\n\nBased on interest and feasibility a suggestion for a flag could be taken into consideration. However, we offer no guarantees of which flags will be added in future versions of Flagpack.\n\n## Building\nYou'll need an `.env` file with a `SPREADSHEET_KEY` and `API_KEY` to be able to build the `generateCodeList.js` script to make the request to the GoogleAPI to fetch the flags data.\n\nIf you just want to make changes to the `generateFlags.js`, the `.env` is not needed, just use the current `countryCodeList.json`.\n\n```bash\n# install dependencies\nnpm install\n\n# build for prod\nnpm run build\n\n# build with watcher for dev\nnpm run dev\n```\n\n## Releasing\nTo release a new version you'll need to make sure all changes commits are done and pushed. After that you'll need to decide which release type you want to use. The release types are; patch (0.0.1), minor (0.1.0), or major (1.0.0).\n```\nnpm version \u003crelease_type\u003e\n```\nThis will update the version number in the `package.json`, and will add a git tag automatically. Next you'll need to push the git tag to the remote.\n```\ngit push --tags origin master\n```\nAfter that you'll need to publish to npm.\n```\nnpm publish\n```\n\nWhen you're confident with the release, make sure the version tag is also released at GitHub.\n\n## Support\n\n[Frequently Asked Questions](http://flagpack.xyz/support/)\n\n[Documentation](http://flagpack.xyz/docs/)\n\n## Releases\n\nYou can find a changelog of Flagpack's releases on the [Releases page](https://github.com/Yummygum/flagpack-core/releases) on GitHub.\n\n## Contribute\n\nIf you're interested in contributing to this project, great! Please see the [contributing document](CONTRIBUTING.md).\n\n## License\n\nFlagpack is an open source project published under a [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyummygum%2Fflagpack-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyummygum%2Fflagpack-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyummygum%2Fflagpack-core/lists"}