💰 Currency Formatter React

A simple, lightweight, and customizable React component for displaying localized currency values using the browser's Intl.NumberFormat API.

---

✨ Features

• 🌐 Supports any locale and currency via Intl.NumberFormat
• ⚙️ Optional control over decimal precision
• 💡 Null-safe rendering
• ⚛️ Tiny, tree-shakable React component

📦 Installation

npm install react-currency-formatter-lite

yarn add react-currency-formatter-lite

🚀 Usage

import React from 'react';
import { CurrencyFormatter } from 'react-currency-formatter-lite';

const App = () => {
  return (
    <div>
      <CurrencyFormatter value={1234.56} />
      <CurrencyFormatter value={1234.56} currency="EUR" locale="de-DE" />
      <CurrencyFormatter value={1234.56} currency="JPY" decimalPrecision={0} />
    </div>
  );
};

⚙️ Props

Prop	Type	Default	Description
value	number | null	required	The numeric value to format
decimalPrecision	number	2	Number of decimal places
locale	string	"en-US"	BCP 47 locale string for localization
currency	string	"USD"	ISO 4217 currency code (e.g. USD, EUR, JPY)

✅ Example Output

<CurrencyFormatter value={1234.56} currency="EUR" locale="de-DE" />
// €1.234,56

📝 License

MIT License © Victor Olayemi