Currency Code to Country Flag

A React component library for displaying country flags based on currency codes or country codes. The package includes local SVG flag files in both square (1:1) and rectangular (4:3) aspect ratios.

Installation

1npm install currency-code-to-country-flag
2# or
3yarn add currency-code-to-country-flag

Usage

You can use the CountryFlag component in two ways:

1. Display flag using currency code

1import { CountryFlag } from "currency-code-to-country-flag";
2
3function App() {
4  return (
5    <div>
6      <CountryFlag currency="USD" />
7      <CountryFlag currency="EUR" />
8      <CountryFlag currency="JPY" />
9      <CountryFlag currency="LAK" />
10      <CountryFlag currency="THB" />
11      <CountryFlag currency="CNY" />
12    </div>
13  );
14}

2. Display flag using country code

1import { CountryFlag } from "currency-code-to-country-flag";
2
3function App() {
4  return (
5    <div>
6      <CountryFlag country="US" />
7      <CountryFlag country="MM" />
8      <CountryFlag country="DE" />
9    </div>
10  );
11}

3. Choose aspect ratio (square or rectangular flags)

1import { CountryFlag } from "currency-code-to-country-flag";
2
3function App() {
4  return (
5    <div>
6      <CountryFlag country="US" ratio="square" /> {/* Square flag (1:1) */}
7      <CountryFlag country="US" ratio="rectangle" /> {/* Rectangular flag (4:3) */}
8    </div>
9  );
10}

Props

Prop	Type	Description	Default
currency	string	ISO 4217 currency code (e.g., 'USD', 'EUR', 'JPY')	-
country	string	ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE')	-
size	'16' | '24' | '32' | '48' | '64'	Size of the flag image in pixels	'32'
ratio	'square' | 'rectangle'	Aspect ratio of the flag (square 1:1 or rectangular 4:3)	'square'
alt	string	Custom alt text for the flag image	Auto-generated
className	string	Additional CSS class names	''
style	React.CSSProperties	Additional inline styles	{}

Notes

• Either currency or country prop must be provided.
• If both are provided, country takes precedence.
• Currency codes are mapped to their primary issuing country.
• All currency and country codes should be provided in ISO standard format.
• The package includes SVG flag files for all countries in both square and rectangular aspect ratios.

Credits

Flag icons provided by flag-icons project.

License

MIT