https://github.com/ghostesso/currency-exchange

"Currency Exchange" is a web application that enables you to convert currencies from various countries. You have the option to select any currency and convert it into another currency available within the system. The application also provides details regarding currency codes and the respective country names associated with each currency.
https://github.com/ghostesso/currency-exchange

css html javascript react reactjs

Last synced: 18 days ago
JSON representation

"Currency Exchange" is a web application that enables you to convert currencies from various countries. You have the option to select any currency and convert it into another currency available within the system. The application also provides details regarding currency codes and the respective country names associated with each currency.

• Host: GitHub
• URL: https://github.com/ghostesso/currency-exchange
• Owner: GhostEsso
• License: mit
• Created: 2023-09-03T19:18:22.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-09-07T06:56:29.000Z (about 1 year ago)
• Last Synced: 2024-10-17T06:16:39.273Z (about 1 month ago)
• Topics: css, html, javascript, react, reactjs
• Language: JavaScript
• Homepage:
• Size: 1.18 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


# 📗 Table of Contents

- [📗 Table of Contents](#-table-of-contents)

- [📖 Currency Exchange ](#-currency-exchange-)

  - [🛠 Built With ](#-built-with-)

    - [Tech Stack ](#tech-stack-)

    - [Key Features ](#key-features-)

  - [Live Demo ](#live-demo-)

  - [💻 Getting Started ](#-getting-started-)

    - [Prerequisites](#prerequisites)

    - [Setup](#setup)

    - [Install](#install)

  - [👥 Authors ](#-authors-)

  - [🔭 Future Features ](#-future-features-)

  - [🤝 Contributing ](#-contributing-)

  - [⭐️ Show your support ](#️-show-your-support-)

  - [🙏 Acknowledgments ](#-acknowledgments-)

  - [📝 License ](#-license-)

# 📖 Currency Exchange 

- Currency Exchange is a web application that facilitates currency exchange between various countries. Users can choose any currency and convert it into another currency supported by the system. Additionally, the app provides details regarding currency codes and the corresponding country names linked to each currency.

## 🛠 Built With 

### Tech Stack 

- This is a mobile and desktop browser responsive website.

  Client

  

- HTML, CSS, JS, REACT

- Technologies Used- HTML, CSS, JS, REACT, GIT, Linters (GitHub Actions, Lighthouse, Webhint, Stylelint, Eslint)

### Key Features 

- Provide cards with flag

- Provide latest prices conversion

- Provide countryName & currency

- Provide other information 

## Live Demo 

- [Link](https://currency-exchange-clnb.onrender.com/)

- [Video](https://www.loom.com/share/266c3ce0534541f0af2014e9a7472d99)

(back to top)


## 💻 Getting Started 

To get a local copy up and running, follow these steps.

### Prerequisites

In order to run this project you need:

- Git

- VsCode or Atom, etc

### Setup

Clone this repository to your desired folder:

- git clone [email protected]:GhostEsso/Currency-Exchange.git

- cd CurrencyExchange

- npm run start

### Install

Install this project with:

- npm Install

## 👥 Authors 

👤 **Essohanam TAMBANA**

- GitHub: [@GhostEsso](https://github.com/GhostEsso)

- Twitter: [@TambanaEssohanam](https://twitter.com/TambanaEssohana)

- LinkedIn: [@TambanaEssohanam](https://www.linkedin.com/in/essohanam-tambana-62aa081a1/)

(back to top)


## 🔭 Future Features 

- Enhance styling.

- System improvement.

- API upgrade.

(back to top)


## 🤝 Contributing 

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/GhostEsso/Currency-Exchange/issues).

(back to top)


## ⭐️ Show your support 

If you like this project, please give it a star, and if you would love to tell us ways to improve it, contact us on LinkedIn or Twitter. It will be a pleasure to hear from you.

(back to top)


## 🙏 Acknowledgments 

- This project was inspired and originally designed by [Nelson Sakwa](https://www.behance.net/sakwadesignstudio) on behance.

- We would like to thank [Microverse](https://www.microverse.org/) for giving this opportunity to learn.

(back to top)


## 📝 License 

This project is [MIT](./LICENSE) licensed.