https://github.com/atia-farha/currency-converter
Currency Converter website with real-time exchange rates!
https://github.com/atia-farha/currency-converter
Last synced: 3 months ago
JSON representation
Currency Converter website with real-time exchange rates!
- Host: GitHub
- URL: https://github.com/atia-farha/currency-converter
- Owner: Atia-Farha
- License: other
- Created: 2024-12-18T19:09:45.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-01-05T04:27:10.000Z (10 months ago)
- Last Synced: 2025-05-14T12:21:25.549Z (5 months ago)
- Language: CSS
- Homepage: https://atia-farha.github.io/currency-converter/
- Size: 51.8 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Currency Converter
A sleek, simple, and user-friendly Currency Converter web application that allows users to convert currencies with real-time exchange rates. It is designed for ease of use to convert one currency into another. It dynamically fetches exchange rates from a reliable API, ensuring users always get the most up-to-date conversion rates.
## Table of Contents
- [Features](#features)
- [Project Structure](#project-structure)
- [Technologies Used](#technologies-used)
- [API Integration](#api-integration)
- [Usage](#usage)
- [Reporting Issues](#reporting-issues)
## Features
- Features a visually appealing dark-themed interface.
- Optimized for performance and responsiveness.
- Fetches the latest rates from [ExchangeRate-API](https://www.exchangerate-api.com/).
- Automatically populates currency options based on available data.
- Includes features such as ARIA labels for enhanced accessibility.
- Gracefully handles API failures or invalid user inputs.
## Project Structure
```plaintext
Currency-Converter/ # Root directory
├── assets/ # Directory for static assets
│ ├── favicon.png # Favicon for the website
│ └── preview.png # Preview image for social sharing.
├── src/ # Source code directory
│ ├── style.css # Main CSS file for styling
│ └── script.js # JavaScript for functionality
├── index.html # Main HTML file
├── README.md # Project documentation
└── LICENSE # License file
```
## Technologies Used
### Frontend:
- HTML5
- CSS3
- JavaScript (ES6+)
### API:
- [ExchangeRate-API](https://www.exchangerate-api.com/)
## API Integration
It uses the ExchangeRate API to fetch real-time exchange rates.
### Key Functions:
fetchRates(): Fetches exchange rates for the selected base currency.
populateCurrencyOptions(): Dynamically populates dropdown menus with available currencies.
convertCurrency(): Calculates and displays the converted amount.
## Usage
1. Simply open this link.
2. Use the first dropdown to select the currency you want to convert from.
3. Input the amount in the base currency.
4. Choose the currency you want to convert to using the second dropdown.
5. Click the "Convert" button or press "Enter" to view the converted amount.
> Ensure that you already have an installed web browser (Chrome, Firefox, etc.) on your device.
## Reporting Issues
If you encounter any bugs or have suggestions for improvement, please report them in the Issues section of this GitHub repository. I will address them promptly.
---
© Designed and developed by Atia Farha | ALL RIGHTS RESERVED