Vector country flag icons in 3x2 aspect ratio.
- Optimized for small size on screen (little detail, minimalism).
- Small file size.
- Comes with React components for all flags (exported from
/react
subpackage).
See the flags (3x2)
npm install country-flag-icons --save
Tells whether there's a flag for a country.
import { hasFlag } from 'country-flag-icons'
hasFlag('US') === true
hasFlag('ZZ') === false
Flags can be linked directly from this library's github pages website.
<img
alt="United States"
src="http://catamphetamine.github.io/country-flag-icons/3x2/US.svg"/>
Unicode flag icons are available under the /unicode
export.
import getUnicodeFlagIcon from 'country-flag-icons/unicode'
getUnicodeFlagIcon('US') === '๐บ๐ธ'
getUnicodeFlagIcon('ZZ') === '๐ฟ๐ฟ'
Unicode flag icons ("Regional Indicator Symbols") were introduced in 2010 in Unicode version 6.0.
Older operating systems might not support Unicode flags, either rendering "missing" (rectangle) characters (if their system doesn't support country flags), or displaying two-letter country codes instead of emoji flag images. For example, Windows 10 currently (01.01.2020) doesn't support Unicode country flags, and displays two-letter country codes instead of emoji flag images.
React components for all flags are available at /react/3x2
export.
import Flags from 'country-flag-icons/react/3x2'
<Flags.US title="United States" className="..."/>
I used Google image search for flag references, and various country flag packs (including FlagKit / flagpack
) for design ideas. Sometimes there was no need to re-draw a flag โ usually in cases when a flag is just a set of colored stripes and there already is a 3x2 SVG version of it somewhere at Wikipedia or some other free flag pack, so in those cases I simply copied those flags (because they look the same in every flag pack).
Some countries officially use their "mother" country flag (those used to be colonies). For example, BV
(Bouvet Island) and SJ
(Svalbard and Jan Mayen) use the flag of Norway; GP
(Guadeloupe) and RE
(Rรฉunion) use the flag of France.