/stone-currency

šŸ’µ web application developed to facilitate the conversion of monetary values ā€‹ā€‹from US dollars to Brazilian reals.

Primary LanguageTypeScript

Stone Currency

šŸ‡ŗšŸ‡ø Do not speak Portuguese? Click here to view the english version.

Stone Currency Ć© uma aplicaĆ§Ć£o web desenvolvida para facilitar a conversĆ£o de valores monetĆ”rios de dĆ³lar para real. Com uma interface amigĆ”vel e intuitiva, a aplicaĆ§Ć£o permite que os usuĆ”rios obtenham rapidamente o valor atualizado de sua moeda estrangeira em reais brasileiros.

Ao abrir a aplicaĆ§Ć£o, o usuĆ”rio Ć© apresentado com dois campos de entrada, onde pode digitar o valor que deseja converter e a taxa do estado. A aplicaĆ§Ć£o Ć© atualizada em tempo real, com taxas de cĆ¢mbio atualizadas de fontes confiĆ”veis, garantindo que o valor exibido seja preciso e atualizado a cada 30 segundos.

Requisitos cumpridos

  • Utilizar React
  • Utilizar TypeScript
  • Criar um cliente HTTP com axios
  • Utilizar uma bilbioteca de cache como swr ou react-query
  • Utlizar styled-components
  • Clonar fielmente o layout do projeto disponibilizado no Figma
  • Fazer testes unitĆ”rios dos componentes
  • Publicar a aplicaĆ§Ć£o em uma plataforma de deploy rĆ”pido como vercel, heroku, netlify ou semelhantes

Tecnologias utilizadas

  • Vite para o build e desenvolvimento da aplicaĆ§Ć£o.
  • React para a construĆ§Ć£o da interface.
  • TypeScript para a tipagem dos dados.
  • Styled Components para a estilizaĆ§Ć£o dos componentes.
  • Axios para a comunicaĆ§Ć£o com a API.
  • Tanstack React Query para o cache de dados e gerenciamento de estado.
  • React Hook Form para a validaĆ§Ć£o dos formulĆ”rios.
  • Zod para a validaĆ§Ć£o dos dados.
  • React Router para a navegaĆ§Ć£o entre pĆ”ginas.
  • Vitest para os testes unitĆ”rios.
  • React Testing Library para a simulaĆ§Ć£o de eventos e interaƧƵes com a interface.

DemonstraĆ§Ć£o

A aplicaĆ§Ć£o estĆ” disponĆ­vel para acesso pĆŗblico em: the-stone-currency.vercel.app

ExecuĆ§Ć£o local

Como executar a aplicaĆ§Ć£o

Para executar a aplicaĆ§Ć£o, Ć© necessĆ”rio ter o Node.js instalado em sua mĆ”quina. ApĆ³s isso, basta clonar o repositĆ³rio, entrar no diretĆ³rio da aplicaĆ§Ć£o e utilizar os seguintes comandos em seu terminal:

# InstalaĆ§Ć£o de dependĆŖncias
$ npm install

# ExecuĆ§Ć£o da aplicaĆ§Ć£o
$ npm run dev

Como executar os testes

Para executar os testes, basta utilizar o seguinte comando no terminal:

# ExecuĆ§Ć£o dos testes
$ npm run test

Como gerar e executar a build da aplicaĆ§Ć£o localmente

Para gerar e executar a build da aplicaĆ§Ć£o, basta utilizar o seguinte comando no terminal:

# Gerar o build da aplicaĆ§Ć£o
$ npm run build

# Executar o preview do build da aplicaĆ§Ć£o
$ npm run preview

šŸ˜ Projeto desenvolvido por Erick Nathan.

ā¬† Voltar ao topo