Currency Changer

Authored by Jeff Chiu

Updated on: 20.nov.2020

A simple money exchanger app for changing USD to other currencies, v1.0, 20.nov.2020

Description:

Keeping track of your money while in foreign lands is a stressful situation. Are you currently getting the best exchange rate from the kiosk at the airport or the ATM that you're stopping at? Currency Changer hopes to take that uncertainty away from users by making things exceptionally easy to see how much they should be getting for their dollar so they can enjoy their vacation in peace.

Site link

Click here to visit the site.

Setup/Installation Requirements:

Software Requirements:

1. Internet browser of choice. Chrome is suggested.

2. A code editor like VSCode or Atom to view or edit the codebase.

Open by downloading:

1. Download this repository onto your computer by clicking the 'clone or download button'.

2. This page utilizes Node package manager and requires local files to be installed. Once you've cloned the repository and it's accompanying config files, use the following command npm install to install the necessary NPM files to display correctly.

3. Currency changer utilizes the ExchangeRate-API. You will need to sign up for a free API key. Free keys are limited to 2000 calls/month.

4. Create a .env file with touch .env in terminal. In that file add your own API key in as follows: API_KEY=xxxxxxxxxxYOURKEYHERExxxxxxxxxxxx. Save the file.

5. Type npm run build to compile the page into the distribution directory.

6. Type npm run start to begin a live server to view the page.

Open via Bash/GitBash:

1. Open terminal window and navigate to/create desired repository location.

2. Clone this repository onto your computer by using command: git clone https://github.com/jeffchiudev/currency-changer

3. In the directory where you've cloned the repository, open in Visual Studio Code with code . or preferred text editor.

4. Follow instructions above regarding set up and API key creation.

Testing Specifications:

Click Here

Description	Input	Ouput
Exchange
Should correctly make API call to ExchangeRate-API		reesponse = 200 OK
Should correctly throw error	API_KEY="invalid"	response = "invalid key"

Known Bugs:

Currently optimized for desktop browsing. Smart device integration will be added soon.

Support and contact details:

If there are any issues, I can be contacted at [email protected]

Technologies Used:

* ExchangeRate-API

* Node

* HTML

* CSS

* ES6

* Webpack

This extension is licensed under the MIT license. Copyright (c) 2020 Jeff W. Chiu