🌍 Currency Info Sphere

Currency Info Sphere is a lightweight JavaScript library that provides comprehensive country and currency information. It includes official country names, currency names, ISO currency codes, country ISO codes, currency symbols, and country flags—all from a local JSON dataset with no API calls required.

Perfect for React, JavaScript, Node.js, and other web applications that need reliable country and currency data.

---

✨ Features

• 🌍 Country information
• 💰 Currency names and ISO currency codes
• 🔤 Currency symbols
• 🚩 Country flags
• 📦 Lightweight and fast
• ⚡ No API key required
• 🌐 Works offline
• 📄 Easy JSON-based data
• 🚀 Compatible with React, Node.js, Next.js, Vue, and other JavaScript frameworks

---

📦 Installation

npm install currency-info-sphere

---

🚀 Usage

import { countriesCurrencyInfo } from "currency-info-sphere";

// Get all countries
console.log(countriesCurrencyInfo);

// Find a specific country
const countryInfo = countriesCurrencyInfo.find(
  (country) => country.name === "United States",
);

console.log(countryInfo);

Example Output

{
  name: "United States",
  commonName: "United States Dollar / Dollar",
  currency: "USD",
  symbol: "$",
  isoCode: "US",
  flag: "us"
}

---

📋 Data Structure

Each object contains the following properties:

Property	Description
name	Official country name
commonName	Common currency name
currency	ISO 4217 currency code
symbol	Currency symbol
isoCode	ISO country code
flag	Country flag code

---

🎥 Demo Video

Watch a quick demonstration of the package:

Demo Video

https://raw.githubusercontent.com/zkromeo/CurrencyInfoSphere/master/public/demo-video.mp4

Note: GitHub README files don't reliably support embedded <video> elements. Linking directly to the video provides a better experience.

---

💡 Use Cases

This package is ideal for:

• Currency converters
• Finance applications
• Banking systems
• E-commerce websites
• Travel applications
• Country selectors
• Internationalization (i18n)
• Educational projects
• Dashboard applications

---

🤝 Contributing

Contributions are welcome!

If you'd like to improve this package:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a Pull Request

---

❤️ Support the Project

If you find this package helpful, please consider:

• ⭐ Starring the GitHub repository
• 🐞 Reporting bugs
• 💡 Suggesting new features
• 🤝 Contributing improvements

---

📄 License

This project is licensed under the MIT License.

---

👨‍💻 Author

Zeeshan Khan

GitHub: https://github.com/zkromeo

---

If you find this package useful, don't forget to ⭐ star the repository on GitHub!