/currency-exchange

Dollar Ex - is a an online digital currency exchange.

Primary LanguageTypeScript

Dollar Ex - Currency Exchange

🟢 Dollar Ex

Dollar Ex - An online digital currency exchange

GitHub language count Repository size GitHub last commit License Stargazers made by viniciusbsneto

Status: Finished 🚧 Writing tests... 🚧

AboutFeaturesPending (to do)How it worksTech StackAuthorLicense

💬 About

Dollar Ex - is a an online digital currency exchange. Try out at https://dollar-ex.netlify.app/


💡 Features

  • Landing page
  • Show last USD quote (bid) in BRL
  • Enter USD amount, state fee and payment type (cash or credit card)
    • Cash payment yields a 1.1% fee
    • Credit card payment yields a 6.4% fee
  • Convert USD amount to BRL
  • Conversion summary
    • Show last USD quote (bid) in BRL
    • Show IOF fee
    • Show USD amount without fees
    • Show USD amount with fees
    • Show BRL amount without fees
    • Show BRL amount with fees

🛠️ Pending (in progress...) ⏳

  1. Tests
  • Write automated E2E tests in Jest/React Testing Library
  1. Isolate reusable components
  • Isolate components that could be reusable in the future. Maybe when extending the application to accomodate other currencies.
  1. Extend to other currencies
  • It would be interesting to extend the app to accomodate other currencies.

📌 Pre-requisites

Before you begin, you will need to have the following tools installed on your machine: [Git] (https://git-scm.com), [Yarn] (https://yarnpkg.com/). In addition, it is good to have an editor to work with the code like [VSCode] (https://code.visualstudio.com/)

Running the web application

# Clone this repository
$ git clone git@github.com:viniciusbsneto/currency-exchange.git

# Access the project folder
$ cd currency-exchange/web

# Install dependencies
$ yarn install

# Start the application
yarn start

# Yarn script will start the application at http://localhost:3000 in your default web browser

🧰 Tech Stack

The following tools were used in the construction of the project:

Dollar Ex Web Application

See the file package.json

Utilitários


🤝 How to contribute

  1. Fork the project.
  2. Create a new branch with your changes: git checkout -b my-feature
  3. Save your changes and create a commit message telling you what you did: git commit -m" feature: My new feature "
  4. Submit your changes: git push origin my-feature

🧑‍💻 Author

Vinícius Neto


Linkedin Badge Gmail Badge


📝 License

This project is under the license MIT.

Made with love by Vinícius Neto 👋🏽 Get in Touch!