tien96ng / currency-exchange

Currency Exchange

Currency exchange web app that takes in a USD amount (U.S Dollars) and displays the equivalent amount in the currency chosen.

By Tien Nguyen

Technologies Used

• HTML5/CSS3
• Bootstrap 4.6.0
• JavaScript ES6
• jQuery 3.5.1
• Node Package Manager 6.14.9
• Webpack 4.39.3
• Babel 7.6.4
• ESlint 6.3.0
• ExchangeRate-Api

Description

Currency converter app using the ExchangeRate-Api, with current emphasis on getting foreign exchange rates from USD to another origin. A user should be able to type in an amount in U.S. dollars and then choose which currency it should be converted to (Example: AUD). By default, the choices are displayed in a dropdown. There is also an "Other" option if the user wants to manually search via input.

Setup/Installation Requirements

Installing NodeJS

1. Install NodeJS from Here!

API Setup

1. Navigate to ExchangeRate-Api to acquire a personal API key.
2. Enter your email address in the box labeled "Your Email Address".
3. Press the "Get Free Key!" button.
4. Finalize your new account creation on the following redirected page.
5. Your API key should be on the account dashboard page following the account creation page.
6. (Optional) You will also be emailed your API key on completion of the account creation.

Local Environment Setup

1. Clone the repo or download the ZIP file of the repo.
2. Navigate to the main directory of the repo.
3. Open the repo's main directory in the Code Editor of your choice.
4. Create a new file named ".env".
5. Enter the following in the .env file: API_KEY="YOUR API KEY HERE" (Without the quotes).
6. Run the following in your terminal within the repo's main directory: "npm install".
7. When the installation is done, run the following in the terminal: "npm run start".

Known Bugs

• None at the moment (2/13/2021)

Project Goals / Further Exploration

• Add Functionality to go back to dropdown instead of manual input via "Other" option.
• Currency Icons
• Currency of Origin Icons / Flags
• Interchangeable Currency conversions (For Example: AUD to EUR).
• Cache API Results in LocalStorage and fetch depending on date (For Example: Fetch API again if Date > 2 Weeks old).
• Show Currency changes over a specific time frame (+/-).

License

This software is licensed under the MIT license
Copyright (c) 2021 Tien Nguyen

Contact Information

[email protected]