Skip to content

CurrencyXchange is a currency converter application developed using React. It allows users to convert one currency to another using real-time exchange rates.

Notifications You must be signed in to change notification settings

yosephdev/currency-converter-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CurrencyXchange

CurrencyXchange Logo

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

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 - Experience CurrencyXchange in action!

Installation

  1. Clone the repository:

    git clone https://github.com/yosephdev/currency-converter-app.git 
    
  2. Navigate to the project directory:

    cd currency-converter-app
    
  3. Install dependencies:

    npm install
    
  4. Start the development server:

    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:

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 - contact@yoseph.dev

Project Link: https://github.com/yosephdev/currency-converter-app

About

CurrencyXchange is a currency converter application developed using React. It allows users to convert one currency to another using real-time exchange rates.

Topics

Resources

Stars

Watchers

Forks