Skip to content

Repository files navigation

🌍 iMGN World Currency Calculator

GitHub repo size
GitHub issues
GitHub stars
GitHub forks
License


🧾 Overview

iMGN World Currency Calculator is a web-based application that allows users to convert between various global currencies in real time. It’s designed to be user-friendly, responsive, and fast — ideal for travelers, finance enthusiasts, or anyone needing quick currency conversions.


✨ Features

  • 🔄 Convert from one currency to another using current exchange rates
  • 📈 Fetches live rates from a currency API
  • 📐 Responsive UI — works on desktop, tablet, and mobile
  • 🧱 Clean, lightweight frontend with HTML, CSS, JavaScript
  • 🛡️ Basic error handling (invalid inputs, API failures)

🛠 Tech Stack

  • HTML5
  • CSS3
  • JavaScript (vanilla)
  • External API (for exchange rates)

📁 Project Structure


iMGN-World-Currency-Calculator/
│── index.html
│── styles.css
│── script.js
│── assets/
│   └── (images, icons, etc.)
│── README.md


🚀 Installation & Usage

  1. Clone this repository:

    git clone https://github.com/itzMaximee/iMGN-World-Currency-Calculator.git
    cd iMGN-World-Currency-Calculator
    
    
  2. (Optional) If your API requires an API key, add it in script.js or a .env (if using build tools).

  3. Open index.html in your browser.

  4. Use the input fields to choose currencies and enter amount, then click “Convert”.


🔗 API & Configuration

  • The app gets exchange rates via an external API (e.g. [exchange rate API name])
  • If an API key is required, place it in script.js (or better: in a config file / environment variable)

🤝 Contributing

Contributions, bug reports, and feature requests are welcome!

  1. Fork the repository
  2. Create a branch: git checkout -b feature/YourFeature
  3. Commit your changes: git commit -m "Add some feature"
  4. Push to the branch: git push origin feature/YourFeature
  5. Open a Pull Request

🧪 Future Enhancements

  • Add support for more currencies or crypto
  • Cache rates to reduce API calls
  • Dark / Light mode toggle
  • History or favorites for quick conversions
  • Use a frontend framework (React, Vue) for better scalability
  • Add unit tests

📜 License

This project is licensed under the MIT License — see the LICENSE file for details.


⚡ Have fun converting currencies!

About

iMGN World Currency Calculator is a web-based application that allows users to convert between various global currencies in real time. It’s designed to be user-friendly, responsive, and fast — ideal for travelers, finance enthusiasts, or anyone needing quick currency conversions. "Made For iMGN Platform By Mohamed Ehab | Maxime"

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages