/CREAM

Epicodus Independent Project, Week 6: Async & APIs

Primary LanguageJavaScript

C.R.E.A.M. [Currency Converter]

Change your money, honey

By Melissa Schatz-Miller

Technologies Used

  • JavaScript
  • webpack
  • HTML
  • CSS

Description

This application will allow users to accurately convert amounts of money between any of the currencies listed in our current currencies [currentcies, if you will] list [see below].

To find out how your money stacks up in other countries, Gentle Reader, all you need do is input any amount in the "cash amount" field, select your home currency & your desired currency in the appropriate drop-downs, and click "Change Money." This app will do the dirty work for you [with a little help from ExchangeRate-API].

Currentcies

  • US Dollars, United States of America
  • UAE Dirham, United Arab Emirates
  • Afghan Afghani, Afghanistan
  • Bermudian Dollar, Bermuda
  • Bolivian Boliviano, Bolivia
  • Falkland Islands Pound, Falkland Islands

Setup/Installation Requirements

  1. Clone this repository to an empty folder or to your desktop.
    Instructions for cloning can be found here.
  2. Open the cream folder in Visual Studio Code or your alternate code editor of choice. Please note that these instructions were written with VS Code MacOS in mind. If you are using a different code editor/OS, the process may vary. You can download VS Code here: VS Code Download
  3. In VS Code, use the Terminal dropdown to open a new Terminal
  4. Run the command npm install to set up the environment
  5. Visit https://www.exchangerate-api.com/ & follow their instructions to get your free API Key
  6. In your terminal, use touch .env to create a new .env file to hold your API Key
  7. Next, run the command npm install dotenv-webpack@2.0.0 --save-dev to let webpack know what's going on
  8. Add the following to your .env file: API_KEY: YOUR-API-KEY-GOES-HERE
  9. Run npm run start to build & access your live development environment
  10. Edit, play, test, convert currency, etc. to your heart's content

Known Bugs

  • No known bugs at this time

License

GPL Copyright (c) 2021, Melissa Schatz-Miller

Contact Information

Melissa Schatz-Miller melissa.scmi@gmail.com

Please feel free to reach out to me with suggested changes/improvements, or if you have any questions.