Currency Exchanger

By Jacob Wilson

An application that converts an amount of currency between different types.

Technologies Used

• HTML
• JavaScript
• CSS
• Markdown
• Bootstrap
• JQuery
• Jest
• Webpack
• Lint
• Postman

Description

This application populates 2 dropdown selections for currencies based on the currencies available in the ExchangeRate-API. After the user has made a selection of a starting currency and an ending currency the application makes an API call based on the starting currency and gets it's exchange rates. Then the application finds the key value with the ending currency, which contains the conversion rate, and calculates how much money that would be after multiplying it by the exchange rate. This information is then displayed to the user. If somehow an unavailable currency were to be selected, or if the api call fails, the application would show an error message to the user.

Setup/Installation Requirements

• You can find the github repository here
• Click the code button, and copy the https link
• In your in git bash or your preferred git terminal navigate to the directory you would like to store the project
• Enter: "git clone" followed by the https link
• Now that the repository is cloned to your computer, right click on the folder and click open with vs code
• Now type npm install in your terminal to install the packages used in the project, you may have to run install twice due to the size of the packages
• To make sure the application works for you, you will need to get your own api key using the following steps:

1. Create an account on the ExchangeRate-API website.
2. If you created an account using the Get Free Key button it will have already generated one for you, If you did not you will be able to generate one by navigating to the Api Keys tab and selecting Add New Api Key
3. Once you have an API key you will need to create a .env file at the top level of the project directory.
4. Type: API_KEY=Your-Api-Key-Here with your API Key instead of the text after the equals sign and save the file.

• You can now view the project by typing npm run start in your terminal
• OR
• You can find the deployed project on gh-pages (here)[https://jlewilson.github.io/currency_exchanger/]

Known Bugs

• No known bugs

License - MIT

If you run into any problems, find a bug, or would like to reach me for a separate reason, feel free to send me an email @jacobleeeugenewilson@gmail.com with details of your issue.

Copyright (c) 11/19/2021 Jacob Wilson(s)