https://github.com/marcosmaio/stone-challenge

Stone Challenge project made by mayself - https://github.com/stone-payments/template-desafio-web
https://github.com/marcosmaio/stone-challenge

Last synced: 23 days ago
JSON representation

Stone Challenge project made by mayself - https://github.com/stone-payments/template-desafio-web

• Host: GitHub
• URL: https://github.com/marcosmaio/stone-challenge
• Owner: MarcosMaio
• Created: 2023-10-02T13:25:42.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-11-08T02:18:47.000Z (about 1 year ago)
• Last Synced: 2023-11-08T08:20:35.723Z (about 1 year ago)
• Language: TypeScript
• Homepage: https://stone-challenge-sigma.vercel.app
• Size: 3.48 MB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Dollar to Real Converter

This project was developed as part of a public challenge proposed by a company. The goal was to create a web application that allows the conversion of dollar values to Brazilian real.

![site illustrato](https://tinypic.host/images/2023/11/05/mobile-3.png)

## Overview

The Dollar to Real Converter application consists of two main steps:

Value Input for Conversion: In this step, the user can enter the dollar amount they wish to convert to Brazilian real.

 Display of Converted Values: After entering the desired amount, the application will fetch the current dollar exchange rate from a currency API and calculate the following values:

- Dollar exchange rate.

- Tax on Financial Operations (IOF).

- Total in dollars without tax.

- Total in dollars with tax.

- Total in Brazilian real without tax.

- Total in Brazilian real with tax.

## Requirements Met

To meet the challenge requirements, the following technologies and practices were implemented:

- Utilization of the specified layout design.

- Development of the application using the React library.

- Use of TypeScript to ensure typing and security.

- Implementation of an HTTP client with Axios to fetch the dollar - exchange rate from the currency API.

- Execution of unit tests to ensure component quality.

- Usage of the SWR library for data loading optimization.

- Utilization of the Styled-Components library to style components.

- Deployment of the application to a fast deployment platform (e.g., Vercel, Heroku, Netlify).

## API Reference

#### Used api to managed to get a dollar exchange rate

```http

  https://docs.awesomeapi.com.br/api-de-moedas

```

## Tech Stack

**Client:** JavaScript, React, Typescript , Styled Componentes

**Server:** HTTP com axios, testes unitários , react-query

## Conclusion

This project represents the successful completion of the challenge proposed by the company. The Dollar to Real Converter application demonstrates the use of modern technologies and best practices in web development. Its functionality is intuitive and meets the established requirements.