---

What this package provides

- Country metadata (name, ISO code, dial code)
- Type-safe country metadata
- CSS-based SVG flags (4:3 and 1:1)
- Works with modern frameworks and plain HTML (CDN)

---

Installation

$3

``bash

pnpm

pnpm add @nofinite/locale

npm

npm install @nofinite/locale

yarn

yarn add @nofinite/locale
`

$3

`html
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/@nofinite/locale/dist/style.css"
/>


`

---

Usage

$3

_(For Javascript/Typescript)_

`ts
import { getCountryByCode, getCountryByDialCode } from '@nofinite/locale';

// Lookup by ISO-2 code (case-insensitive)
const in = getCountryByCode('IN');

// Lookup by dial code
const india = getCountryByDialCode('+91');
// or
const indiaAlt = getCountryByDialCode('91');

console.log(india);

/*
{
name: "India",
iso2: "IN",
dialCode: "+91"
}
*/
`

_(For HTML)_

`html

`

---

$3

Flags are provided via CSS. Import the stylesheet once.

_(For Javascript/Typescript)_

`ts
import "@nofinite/locale/style";
`

_(For HTML)_

`html
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/@nofinite/locale/dist/style.css"
/>
`

Flag Classes

| Class | Purpose |
| ---------------- | ------------------------------ |
| .nf-flag | Base flag class (required) |
| .nf-flag-{iso} | Country ISO-2 code (lowercase) |
| .square | Optional 1:1 ratio |

Examples

- Standard (4:3)



- Square (1:1)



- Inside UI Elements

`html


Select Language

``

---

License

This project is licensed under the
Apache License, Version 2.0.

Feel free to use, modify, and share this project in your applications, products, and services. Attribution is welcome and appreciated, but never required.