Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yosephdev/currency-converter-app
CurrencyXchange is a currency converter application developed using React. It allows users to convert one currency to another using real-time exchange rates.
https://github.com/yosephdev/currency-converter-app
css3 html5 jaavscript reactjs
Last synced: 4 days ago
JSON representation
CurrencyXchange is a currency converter application developed using React. It allows users to convert one currency to another using real-time exchange rates.
- Host: GitHub
- URL: https://github.com/yosephdev/currency-converter-app
- Owner: yosephdev
- Created: 2020-02-18T16:49:45.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-16T18:24:41.000Z (3 months ago)
- Last Synced: 2024-08-16T19:43:00.974Z (3 months ago)
- Topics: css3, html5, jaavscript, reactjs
- Language: JavaScript
- Homepage: https://currency-x-change.netlify.app/
- Size: 1.25 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CurrencyXchange
CurrencyXchange is a robust and user-friendly application designed for real-time currency conversion and exchange rate information. With a sleek and intuitive interface, it provides users with accurate and up-to-date financial data.
## Table of Contents
- [CurrencyXchange](#currencyxchange)
- [Table of Contents](#table-of-contents)
- [Features](#features)
- [Demo](#demo)
- [Installation](#installation)
- [Contributing](#contributing)
- [Contact](#contact)
## Features
- **Real-Time Exchange Rates**: Fetches the latest exchange rates from reliable financial APIs.
- **Currency Converter**: Allows users to convert amounts between different currencies effortlessly.
- **Interactive Charts**: Visualize historical exchange rate data with responsive and interactive charts.
- **Support for Multiple Currencies**: Extensive support for various global currencies.
- **Responsive Design**: Optimized for both desktop and mobile devices.
- **Offline Support**: Basic functionality available without an internet connection.
## Demo
[Live Demo](https://currency-x-change.netlify.app/) - Experience CurrencyXchange in action!
## Installation
1. Clone the repository:
```sh
git clone https://github.com/yosephdev/currency-converter-app.git
2. Navigate to the project directory:
```sh
cd currency-converter-app
3. Install dependencies:
```sh
npm install
4. Start the development server:
```sh
npm start
## Usage
- **Select a Base Currency**: Choose a base currency and input an amount to initiate conversion.
- **View Exchange Rates**: The app will display current exchange rates for various currencies.
- **Currency Conversion**: Utilize the converter tool to calculate and compare amounts in various currencies.
- **Explore Charts**: Navigate to the charts section to view historical exchange rate trends.
## Technologies Used
- React.js
- Chart.js
- Material-UI
- Frankfurter API for exchange rates
## API Reference
This project uses the Frankfurter API for fetching real-time and historical exchange rate data.
Example API call:
```sh
GET https://api.frankfurter.app/latest?from=USD
```
## Contributing
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## Contact
Yoseph Berhane - [email protected]
Project Link: [https://github.com/yosephdev/currency-converter-app](https://github.com/yosephdev/currency-converter-app)