Currency converter

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Logic and features
4. Contributing
5. Contact

About The Project

This Currency Converter is a simple yet powerful tool that allows users to quickly and accurately convert between different currencies in real-time. The project is designed to be intuitive, fast, and responsive, making it easy for users to check exchange rates and perform conversions effortlessly.

I decided to develop this application to learn more about working with APIs in React. I also wanted to develop an application with logic of medium complexity.

(back to top)

Built With

• 

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

• npm

  npm install npm@latest -g

Installation

1. Get a free API Key at https://www.exchangerate-api.com/
2. Clone the repo

   git clone https://github.com/alria-k/currency-converter

3. Install NPM packages

   npm install

4. Create .env file
5. Enter your API key in .env

   VITE_API_KEY="ENTER YOUR API";

6. Change git remote url to avoid accidental pushes to base project

   git remote set-url origin github_username/repo_name
   git remote -v # confirm the changes

(back to top)

Logic and features

◉ Currency conversion


◉ Drop-down list with 161 countries to choose from


◉ Swap if only two countries are converted


◉ Entering an amount in any field converts the amount based on the main conversion country.


◉ Adding up to 5 countries for simultaneous conversion (when adding, the country is selected randomly)


◉ Deletion of any conversion field


◉ You will not be able to select the same countries


◉ Display indicative exchange rate

(back to top)

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.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

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

(back to top)

Contact

Artur - LinkedIn - [email protected]

Project Link: https://github.com/alria-k/currency-converter

(back to top)