GitHunt
AR

Arsh-pixel-cmd/Currency-Converter-X

Currency Converter X is a responsive web application that allows users to convert between 30+ world currencies using real-time exchange rates via the Frankfurter API. It features dynamic flag updates, sound feedback, and a dark/light theme toggle — all built using only HTML, CSS, and JavaScript with no frameworks.

💱 Currency Converter X

Currency Converter X is a responsive, interactive, and real-time web app that allows users to convert between over 30 currencies using the Frankfurter API. It includes dark/light theme toggle, country flag support, and even a sound effect on conversion.


🚀 Features

  • 🔄 Live exchange rate updates using Frankfurter API
  • 🌐 Dropdowns auto-update country flags
  • 🌓 Toggle between dark and light modes
  • 💻 Mobile-first responsive layout
  • 🧠 Simple, clean, and intuitive interface

🛠️ Technologies Used

  • HTML5
  • CSS3
  • JavaScript (Vanilla)
  • Frankfurter API (currency data)
  • FlagsAPI (country flags)

📁 Project Structure

Currency-Converter-X/

├── index.html # Main HTML structure of the web app
├── style.css # All CSS styles for layout, themes, responsiveness
├── app.js # Handles dynamic behavior: dropdowns, flags, API fetch, theme toggle
├── codes.js # Stores currency-country mappings used in dropdowns

├── assets/ # Folder for static assets (images, screenshots, etc.)
│ └── screenshots/ # Screenshots used in README or documentation
│ ├── dark-mode.png # Screenshot of the dark mode interface
│ └── light-mode.png # Screenshot of the light mode interface

├── .gitignore # Prevents unnecessary files from being committed to GitHub
└── README.md # Full documentation and instructions for the project


🧪 How It Works

  1. Enter any amount in the input field.
  2. Choose base (From) and target (To) currencies.
  3. Click “Get Exchange Rate” to fetch and display the latest rate.
  4. The app updates country flags when successful.
  5. Toggle the switch to change between light and dark themes.

💻 Run Locally

git clone https://github.com/Arsh-pixel-cmd/Currency-Converter-X.git
cd Currency-Converter-X

Open index.html in any modern browser, or

Run using Live Server in VS Code.

📷 Screenshots

🌑 Dark Mode

Dark Mode

🌕 Light Mode

Light Mode

📌 License
This project is licensed under the MIT License.

⭐️ If you like this project...
Please consider giving it a ⭐️ on GitHub and sharing it with others!