React Currency Exchange App

The React Currency Exchange App is a web-based application designed to facilitate currency exchange, specifically focusing on the exchange of currencies. This app is built using React, a popular JavaScript library for building user interfaces, and it leverages Vite for creating development and production environments efficiently. Additionally, it utilizes styled-components for styling to ensure a visually appealing and responsive user experience.

Table of Contents

• Getting Started
  • Prerequisites
  • Installation
• Development
  • Running the Development Server
  • Build for Production
• Styling
• Features
  • Currency Conversion
• Deployment
  • Live Demo
• Usage
• Contributing
• License

Getting Started

Prerequisites

Before you begin, ensure you have the following software installed:

• Node.js and npm (Node Package Manager)
• Git

Installation

1. Clone this repository:

   git clone https://github.com/yourusername/react-crypto-exchange-app.git

2. Install dependencies:

   cd react-crypto-exchange-app
   npm install

3. Run the development server:

   npm run dev

Development

Running the Development Server

To start the development server, run the following command:

npm run dev

This will start the development server using Vite, and you can access the app in your browser at http://localhost:3000.

Build for Production

To build the app for production, run the following command:

npm run build

This will build the app using Vite, and you can access the app in your browser at http://localhost:5173.

Styling

This app uses styled-components to style its components. The styles are defined within each component's JavaScript file using tagged template literals. You can customize the styles as needed by modifying the styled-components.

Features

Currency Conversion

The primary feature of the app is currency conversion. Users can perform the following steps:

1. Select Base Currency: Users can choose their base currency from a dropdown list. This currency represents the value they want to convert from.

2. Enter Amount: Users can input the amount they wish to convert.

3. Select Target Currency: Users can select the target currency to which they want to convert their funds. This currency is also chosen from a dropdown list.

4. Conversion Result: After selecting the base currency, entering an amount, and choosing the target currency, the app will calculate and display the converted amount in the target currency. It provides real-time currency exchange rates for accurate conversions.

Deployment

The app is deployed using Netlify.

🚀 Live Demo

• Live Demo Link

Usage

1. Launch the app by following the instructions under "Running the Development Server."

2. Use the app to convert currencies:

   • Select the base currency from the dropdown.
   • Enter the amount you want to convert.
   • Choose the target currency from another dropdown.
   • The converted amount will be displayed.
   • Explore additional features and functionalities as per your app's documentation.

Contributing

Contributions are welcome! If you'd like to contribute to this project, please follow these steps:

Fork the repository. Create a new branch for your feature or bug fix. Make your changes and test them thoroughly. Submit a pull request with a clear description of your changes. Please make sure your code follows the existing coding style and includes appropriate documentation.

📝 License

This project is MIT licensed.