# Appica Country Flags for React

> 262 high-fidelity SVG country flags in rounded and circle shapes for React (`@appica/country-flags-react`). Designs are based on the Country Flags Figma community file, refined for accuracy and legibility at small sizes.

This file is for AI agents: install and usage, the naming rule, and every flag's code and component names. The same flags ship for Svelte (https://appica.dev/ui/country-flags/svelte.md). What changed in each release: https://github.com/appica-dev/appica-country-flags/blob/main/packages/react/CHANGELOG.md

## Install

`pnpm add @appica/country-flags-react` (npm / yarn / bun also work). Requires React 19+, ESM only.

## Usage

```tsx
import { CountryFlagRounded, CountryFlagCircle, USRounded } from '@appica/country-flags-react'

// dynamic - resolve by ISO code at runtime
<CountryFlagRounded code="us" size={32} />
<CountryFlagCircle code="us" size="2rem" />

// static - individual import, optimal tree-shaking
<USRounded size={24} />
```

- Two ways to render a flag: **dynamic** - `CountryFlagRounded` / `CountryFlagCircle` resolve a flag from the `code` prop at runtime (useful for data-driven lists); **static** - import the per-flag component directly for optimal tree-shaking. A dynamic component bundles every flag of its shape (about 70 KB gzipped), so prefer static imports for flags known ahead of time.
- Props: `code` (dynamic components only), `size` (string | number, default `"1em"`), `title` (accessible label rendered as an SVG `<title>`; when omitted the flag is `aria-hidden`), `className`, `style`, plus all standard SVG props.
- The `CountryFlagProps` type is exported for typing your own wrappers.

## Names

- A static component's name is the code uppercased with hyphens removed, plus the shape suffix: `us` → `USRounded` / `USCircle`, `gb-sct` → `GBSCTRounded` / `GBSCTCircle`. The names are the same in every integration.
- The dynamic `CountryFlagRounded` / `CountryFlagCircle` take the code itself, e.g. `code="gb-sct"` (case-insensitive).

## Catalog

262 flags, sorted by name. Pass the Code to a dynamic component, or import the static name for its shape.

| Code | Country / Region | Rounded | Circle |
| --- | --- | --- | --- |
| xa | Abkhazia | XARounded | XACircle |
| af | Afghanistan | AFRounded | AFCircle |
| ax | Åland Islands | AXRounded | AXCircle |
| al | Albania | ALRounded | ALCircle |
| dz | Algeria | DZRounded | DZCircle |
| as | American Samoa | ASRounded | ASCircle |
| ad | Andorra | ADRounded | ADCircle |
| ao | Angola | AORounded | AOCircle |
| ai | Anguilla | AIRounded | AICircle |
| ag | Antigua & Barbuda | AGRounded | AGCircle |
| ar | Argentina | ARRounded | ARCircle |
| am | Armenia | AMRounded | AMCircle |
| aw | Aruba | AWRounded | AWCircle |
| au | Australia | AURounded | AUCircle |
| at | Austria | ATRounded | ATCircle |
| az | Azerbaijan | AZRounded | AZCircle |
| pt-20 | Azores | PT20Rounded | PT20Circle |
| bs | Bahamas | BSRounded | BSCircle |
| bh | Bahrain | BHRounded | BHCircle |
| ib | Balearic Islands | IBRounded | IBCircle |
| bd | Bangladesh | BDRounded | BDCircle |
| bb | Barbados | BBRounded | BBCircle |
| es-pv | Basque Country | ESPVRounded | ESPVCircle |
| by | Belarus | BYRounded | BYCircle |
| be | Belgium | BERounded | BECircle |
| bz | Belize | BZRounded | BZCircle |
| bj | Benin | BJRounded | BJCircle |
| bm | Bermuda | BMRounded | BMCircle |
| bt | Bhutan | BTRounded | BTCircle |
| bo | Bolivia | BORounded | BOCircle |
| bq-ba | Bonaire | BQBARounded | BQBACircle |
| ba | Bosnia & Herzegovina | BARounded | BACircle |
| bw | Botswana | BWRounded | BWCircle |
| br | Brazil | BRRounded | BRCircle |
| io | British Indian Ocean Territory | IORounded | IOCircle |
| vg | British Virgin Islands | VGRounded | VGCircle |
| bn | Brunei | BNRounded | BNCircle |
| bg | Bulgaria | BGRounded | BGCircle |
| bf | Burkina Faso | BFRounded | BFCircle |
| bi | Burundi | BIRounded | BICircle |
| kh | Cambodia | KHRounded | KHCircle |
| cm | Cameroon | CMRounded | CMCircle |
| ca | Canada | CARounded | CACircle |
| ic | Canary Islands | ICRounded | ICCircle |
| cv | Cape Verde | CVRounded | CVCircle |
| ky | Cayman Islands | KYRounded | KYCircle |
| cf | Central African Republic | CFRounded | CFCircle |
| es-ce | Ceuta | ESCERounded | ESCECircle |
| td | Chad | TDRounded | TDCircle |
| cl | Chile | CLRounded | CLCircle |
| cn | China | CNRounded | CNCircle |
| cx | Christmas Island | CXRounded | CXCircle |
| cc | Cocos (Keeling) Islands | CCRounded | CCCircle |
| co | Colombia | CORounded | COCircle |
| km | Comoros | KMRounded | KMCircle |
| cg | Congo - Brazzaville | CGRounded | CGCircle |
| cd | Congo - Kinshasa | CDRounded | CDCircle |
| ck | Cook Islands | CKRounded | CKCircle |
| fr-2b | Corsica | FR2BRounded | FR2BCircle |
| cr | Costa Rica | CRRounded | CRCircle |
| ci | Côte d’Ivoire | CIRounded | CICircle |
| hr | Croatia | HRRounded | HRCircle |
| cu | Cuba | CURounded | CUCircle |
| cw | Curaçao | CWRounded | CWCircle |
| cy | Cyprus | CYRounded | CYCircle |
| cz | Czechia | CZRounded | CZCircle |
| dk | Denmark | DKRounded | DKCircle |
| dj | Djibouti | DJRounded | DJCircle |
| dm | Dominica | DMRounded | DMCircle |
| do | Dominican Republic | DORounded | DOCircle |
| ec | Ecuador | ECRounded | ECCircle |
| eg | Egypt | EGRounded | EGCircle |
| sv | El Salvador | SVRounded | SVCircle |
| gb-eng | England | GBENGRounded | GBENGCircle |
| gq | Equatorial Guinea | GQRounded | GQCircle |
| er | Eritrea | ERRounded | ERCircle |
| ee | Estonia | EERounded | EECircle |
| sz | Eswatini | SZRounded | SZCircle |
| et | Ethiopia | ETRounded | ETCircle |
| eu | European Union | EURounded | EUCircle |
| fk | Falkland Islands | FKRounded | FKCircle |
| fo | Faroe Islands | FORounded | FOCircle |
| fj | Fiji | FJRounded | FJCircle |
| fi | Finland | FIRounded | FICircle |
| fr | France | FRRounded | FRCircle |
| gf | French Guiana | GFRounded | GFCircle |
| pf | French Polynesia | PFRounded | PFCircle |
| tf | French Southern Territories | TFRounded | TFCircle |
| ga | Gabon | GARounded | GACircle |
| ec-w | Galapagos Islands | ECWRounded | ECWCircle |
| gm | Gambia | GMRounded | GMCircle |
| ge | Georgia | GERounded | GECircle |
| de | Germany | DERounded | DECircle |
| gh | Ghana | GHRounded | GHCircle |
| gi | Gibraltar | GIRounded | GICircle |
| gr | Greece | GRRounded | GRCircle |
| gl | Greenland | GLRounded | GLCircle |
| gd | Grenada | GDRounded | GDCircle |
| gu | Guam | GURounded | GUCircle |
| gt | Guatemala | GTRounded | GTCircle |
| gg | Guernsey | GGRounded | GGCircle |
| gn | Guinea | GNRounded | GNCircle |
| gw | Guinea-Bissau | GWRounded | GWCircle |
| gy | Guyana | GYRounded | GYCircle |
| ht | Haiti | HTRounded | HTCircle |
| hm | Heard & McDonald Islands | HMRounded | HMCircle |
| hn | Honduras | HNRounded | HNCircle |
| hk | Hong Kong SAR China | HKRounded | HKCircle |
| hu | Hungary | HURounded | HUCircle |
| is | Iceland | ISRounded | ISCircle |
| in | India | INRounded | INCircle |
| id | Indonesia | IDRounded | IDCircle |
| ir | Iran | IRRounded | IRCircle |
| iq | Iraq | IQRounded | IQCircle |
| ie | Ireland | IERounded | IECircle |
| im | Isle of Man | IMRounded | IMCircle |
| il | Israel | ILRounded | ILCircle |
| it | Italy | ITRounded | ITCircle |
| jm | Jamaica | JMRounded | JMCircle |
| jp | Japan | JPRounded | JPCircle |
| je | Jersey | JERounded | JECircle |
| jo | Jordan | JORounded | JOCircle |
| kz | Kazakhstan | KZRounded | KZCircle |
| ke | Kenya | KERounded | KECircle |
| ki | Kiribati | KIRounded | KICircle |
| xk | Kosovo | XKRounded | XKCircle |
| kw | Kuwait | KWRounded | KWCircle |
| kg | Kyrgyzstan | KGRounded | KGCircle |
| la | Laos | LARounded | LACircle |
| lv | Latvia | LVRounded | LVCircle |
| lb | Lebanon | LBRounded | LBCircle |
| ls | Lesotho | LSRounded | LSCircle |
| lr | Liberia | LRRounded | LRCircle |
| ly | Libya | LYRounded | LYCircle |
| li | Liechtenstein | LIRounded | LICircle |
| lt | Lithuania | LTRounded | LTCircle |
| lu | Luxembourg | LURounded | LUCircle |
| mo | Macao SAR China | MORounded | MOCircle |
| mg | Madagascar | MGRounded | MGCircle |
| pt-30 | Madeira | PT30Rounded | PT30Circle |
| mw | Malawi | MWRounded | MWCircle |
| my | Malaysia | MYRounded | MYCircle |
| mv | Maldives | MVRounded | MVCircle |
| ml | Mali | MLRounded | MLCircle |
| mt | Malta | MTRounded | MTCircle |
| mh | Marshall Islands | MHRounded | MHCircle |
| mq | Martinique | MQRounded | MQCircle |
| mr | Mauritania | MRRounded | MRCircle |
| mu | Mauritius | MURounded | MUCircle |
| yt | Mayotte | YTRounded | YTCircle |
| es-ml | Melilla | ESMLRounded | ESMLCircle |
| mx | Mexico | MXRounded | MXCircle |
| fm | Micronesia | FMRounded | FMCircle |
| md | Moldova | MDRounded | MDCircle |
| mc | Monaco | MCRounded | MCCircle |
| mn | Mongolia | MNRounded | MNCircle |
| me | Montenegro | MERounded | MECircle |
| ms | Montserrat | MSRounded | MSCircle |
| ma | Morocco | MARounded | MACircle |
| mz | Mozambique | MZRounded | MZCircle |
| mm | Myanmar (Burma) | MMRounded | MMCircle |
| na | Namibia | NARounded | NACircle |
| nr | Nauru | NRRounded | NRCircle |
| np | Nepal | NPRounded | NPCircle |
| nl | Netherlands | NLRounded | NLCircle |
| nc | New Caledonia | NCRounded | NCCircle |
| nz | New Zealand | NZRounded | NZCircle |
| ni | Nicaragua | NIRounded | NICircle |
| ne | Niger | NERounded | NECircle |
| ng | Nigeria | NGRounded | NGCircle |
| nu | Niue | NURounded | NUCircle |
| nf | Norfolk Island | NFRounded | NFCircle |
| kp | North Korea | KPRounded | KPCircle |
| mk | North Macedonia | MKRounded | MKCircle |
| mp | Northern Mariana Islands | MPRounded | MPCircle |
| no | Norway | NORounded | NOCircle |
| om | Oman | OMRounded | OMCircle |
| gb-ork | Orkney Islands | GBORKRounded | GBORKCircle |
| pk | Pakistan | PKRounded | PKCircle |
| pw | Palau | PWRounded | PWCircle |
| ps | Palestinian Territories | PSRounded | PSCircle |
| pa | Panama | PARounded | PACircle |
| pg | Papua New Guinea | PGRounded | PGCircle |
| py | Paraguay | PYRounded | PYCircle |
| pe | Peru | PERounded | PECircle |
| ph | Philippines | PHRounded | PHCircle |
| pn | Pitcairn Islands | PNRounded | PNCircle |
| pl | Poland | PLRounded | PLCircle |
| pt | Portugal | PTRounded | PTCircle |
| pr | Puerto Rico | PRRounded | PRCircle |
| qa | Qatar | QARounded | QACircle |
| re | Réunion | RERounded | RECircle |
| ro | Romania | RORounded | ROCircle |
| ru | Russia | RURounded | RUCircle |
| rw | Rwanda | RWRounded | RWCircle |
| bq-sa | Saba Island | BQSARounded | BQSACircle |
| ws | Samoa | WSRounded | WSCircle |
| sm | San Marino | SMRounded | SMCircle |
| st | São Tomé & Príncipe | STRounded | STCircle |
| it-88 | Sardinia | IT88Rounded | IT88Circle |
| sa | Saudi Arabia | SARounded | SACircle |
| gb-sct | Scotland | GBSCTRounded | GBSCTCircle |
| sn | Senegal | SNRounded | SNCircle |
| rs | Serbia | RSRounded | RSCircle |
| sc | Seychelles | SCRounded | SCCircle |
| sl | Sierra Leone | SLRounded | SLCircle |
| sg | Singapore | SGRounded | SGCircle |
| bq-se | Sint Eustatius | BQSERounded | BQSECircle |
| sx | Sint Maarten | SXRounded | SXCircle |
| sk | Slovakia | SKRounded | SKCircle |
| si | Slovenia | SIRounded | SICircle |
| sb | Solomon Islands | SBRounded | SBCircle |
| so | Somalia | SORounded | SOCircle |
| za | South Africa | ZARounded | ZACircle |
| kr | South Korea | KRRounded | KRCircle |
| xo | South Ossetia | XORounded | XOCircle |
| ss | South Sudan | SSRounded | SSCircle |
| es | Spain | ESRounded | ESCircle |
| lk | Sri Lanka | LKRounded | LKCircle |
| bl | St. Barthélemy | BLRounded | BLCircle |
| kn | St. Kitts & Nevis | KNRounded | KNCircle |
| lc | St. Lucia | LCRounded | LCCircle |
| vc | St. Vincent & Grenadines | VCRounded | VCCircle |
| sd | Sudan | SDRounded | SDCircle |
| sr | Suriname | SRRounded | SRCircle |
| se | Sweden | SERounded | SECircle |
| ch | Switzerland | CHRounded | CHCircle |
| sy | Syria | SYRounded | SYCircle |
| tw | Taiwan | TWRounded | TWCircle |
| tj | Tajikistan | TJRounded | TJCircle |
| tz | Tanzania | TZRounded | TZCircle |
| th | Thailand | THRounded | THCircle |
| cn-xz | Tibet | CNXZRounded | CNXZCircle |
| tl | Timor-Leste | TLRounded | TLCircle |
| tg | Togo | TGRounded | TGCircle |
| tk | Tokelau | TKRounded | TKCircle |
| to | Tonga | TORounded | TOCircle |
| tt | Trinidad & Tobago | TTRounded | TTCircle |
| tn | Tunisia | TNRounded | TNCircle |
| tr | Türkiye | TRRounded | TRCircle |
| tm | Turkmenistan | TMRounded | TMCircle |
| tc | Turks & Caicos Islands | TCRounded | TCCircle |
| tv | Tuvalu | TVRounded | TVCircle |
| vi | U.S. Virgin Islands | VIRounded | VICircle |
| ug | Uganda | UGRounded | UGCircle |
| ua | Ukraine | UARounded | UACircle |
| ae | United Arab Emirates | AERounded | AECircle |
| gb | United Kingdom | GBRounded | GBCircle |
| un | United Nations | UNRounded | UNCircle |
| us | United States | USRounded | USCircle |
| uy | Uruguay | UYRounded | UYCircle |
| uz | Uzbekistan | UZRounded | UZCircle |
| vu | Vanuatu | VURounded | VUCircle |
| va | Vatican City | VARounded | VACircle |
| ve | Venezuela | VERounded | VECircle |
| vn | Vietnam | VNRounded | VNCircle |
| gb-wls | Wales | GBWLSRounded | GBWLSCircle |
| wf | Wallis & Futuna | WFRounded | WFCircle |
| eh | Western Sahara | EHRounded | EHCircle |
| ye | Yemen | YERounded | YECircle |
| zm | Zambia | ZMRounded | ZMCircle |
| zw | Zimbabwe | ZWRounded | ZWCircle |