flemton/currency-converter

The Currency Converter is a web application designed for converting any currency to another, the default conversion is from the clicked/tapped currency to the US dollar but you can also convert from any desired currency to another using the form in the details page by entering the symbols for currencies you want to convert.

Currency Converter

📗 Table of Contents

• 📗 Table of Contents
• 📖 Currency Converter
• 📖 Video Description
  • 🛠 Built With
    • Tech Stack
    • Key Features
  • 🚀 Live Demo
  • 💻 Getting Started
    • Prerequisites
    • Setup
    • Install
    • Usage
    • Run tests
    • Deployment
  • 👥 Authors
  • 🔭 Future Features
  • 🤝 Contributing
  • ⭐️ Show your support
  • 🙏 Acknowledgments
  • 📝 License

📖 Currency Converter

The Currency Converter is a web application designed for converting any currency to another, the default conversion is from the clicked/tapped currency to the US dollar but you can also convert from any desired currency to another using the form in the details page by entering the symbols for currencies you want to convert.

Video Description

Loom video describing project

🛠 Built With

Tech Stack

HTML

• HTML

CSS

• CSS

Javascript

• Javascript

Key Features

• Use React documentation.
• Use React components.
• Use React props.
• Use React Router.
• Connect React and Redux.
• Handle events in a React app.
• Write unit tests with React Testing Library.
• Use styles in a React app.
• Use React hooks.
• Apply React best practices and language style guides in code.
• Use store, actions and reducers in React.

(back to top)

🚀 Live Demo

• Here is the live demo version.

(back to top)

💻 Getting Started

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

clone this repository into your machine
npm install
npm start

Prerequisites

In order to run this project you need:

• Create a repo on your repositores files.
• Clone or make a copy of this repo on your local machine.
• Follow the install instructions

Setup

Clone this repository to your desired folder:

cd my-folder
git clone git@github.com:flemton/currency-converter.git

Install

Install this project with:

npm install

Usage

To run the project, you can use your favorite browser.

Run tests

To run tests, execute the following command:

 npm test

Deployment

• N/A

(back to top)

👥 Author

👤 Alhassan Osman

• GitHub: @flemton
• Twitter: @oalhassan847
• LinkedIn: Alhassan Osman

(back to top)

🔭 Future Features

• Past conversions
• Web socket

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

If you like this project feel free to make any comment, all contributions are welcome!.

(back to top)

🙏 Acknowledgments

I would like to thank the Microverse comunity,Nelson Sakwa for this perfect design, my morning session partners, teammates and standup partners for supporting me.

(back to top)

📝 License

This project is Creative Commons licensed.

👥 Author

👤 Alhassan Osman

• GitHub: @flemton
• Twitter: @oalhassan847
• LinkedIn: Alhassan Osman

(back to top)

🔭 Future Features

• Past conversions
• Web socket

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

If you like this project feel free to make any comment, all contributions are welcome!.

(back to top)

🙏 Acknowledgments

I would like to thank the Microverse comunity,Nelson Sakwa for this perfect design, my morning session partners, teammates and standup partners for supporting me.

(back to top)

📝 License

This project is Creative Commons licensed.

(back to top)