2

Simple Currency Converter using React

This simple currency converter is a React-based web application that allows users to convert currency values. It utilizes Axios for API requests and integrates Tailwind CSS for styling.

Table of Contents

  1. About
  2. Features
  3. Project Structure
  4. Demo Images
  5. Installation
  6. Usage
  7. Technologies Used

About

This repository contains a simple currency converter React app built to assist users in converting currencies easily. The app features an InputBox component, hooks for fetching currency lists and conversion rates, and an App component that ties everything together for seamless currency conversion.

Features

  • Conversion of currency values
  • InputBox component for entering amounts and selecting currencies
  • API integration using Axios for fetching currency data
  • Responsive UI design with Tailwind CSS

Project Structure

The project directory structure is organized as follows:

simpleCurrencyConverter/
├── src/
│ ├── components/
│ │ ├── InputBox.jsx
│ ├── hooks/
│ │ ├── useCurrencyConvert.jsx
│ │ ├── useCurrencyList.jsx
│ ├── App.jsx
│ ├── index.css
├── package.json
└── README.md

Demo Images

1

2

4

3

Installation

  1. Clone the repository:

    git clone https://github.com/mustafa854/react-currency-converter.git
    cd simpleCurrencyConverter
  2. Install dependencies:

    npm install

Usage

  1. Start the development server:

    npm start
  2. Open your browser and go to http://localhost:3000 to view the application.

  3. Enter the amount, select the currencies, and click 'Convert' to see the converted amount.

Technologies Used

  • React
  • Axios
  • Tailwind CSS