Skip to content

README.md

Latest commit

 

History

History
121 lines (78 loc) · 2.37 KB

README.md

File metadata and controls

121 lines (78 loc) · 2.37 KB
Raw

Currency Calculator

Overview

Currency Calculator is a lightweight, browser-based web application designed to perform accurate and real-time currency conversions. The project demonstrates structured frontend development, clean code organization, and seamless integration with a currency exchange rate API.

The application enables users to convert monetary values between different international currencies using live exchange rate data.

Objectives

  • Provide real-time currency conversion
  • Demonstrate client-side API integration
  • Maintain a clean and maintainable codebase
  • Deliver a responsive and professional user interface

Features

  • Real-time exchange rate retrieval
  • Instant currency conversion
  • Dynamic currency selection
  • Responsive layout for various screen sizes
  • Clear and minimal interface design

Technology Stack

  • HTML5 — Application structure
  • CSS3 / Tailwind CSS — Styling and layout
  • JavaScript (ES6) — Application logic and API handling
  • Exchange Rate API — Live currency data source

Project Structure

Currency-Calculator/ │ ├── index.html ├── style.css ├── script.js └── README.md

Installation

Clone the Repository

git clone https://github.com/Zoraiz03/Currency-Calculator.git

Navigate to the Project Directory

cd Currency-Calculator

Run the Application

Open the index.html file in any modern web browser.

No additional dependencies or build configuration are required.

Application Workflow

  1. Select the base currency.
  2. Select the target currency.
  3. Enter the amount to convert.
  4. The system fetches the latest exchange rate.
  5. The converted value is displayed instantly.

Use Cases

  • Frontend development practice
  • API integration learning
  • Academic coursework
  • Portfolio demonstration

Future Enhancements

  • Historical exchange rate visualization
  • Dark and light theme support
  • Enhanced validation and error handling
  • Offline fallback capability
  • Extended currency coverage

Contribution

Contributions are welcome. To contribute:

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes with clear and descriptive messages
  4. Submit a pull request for review

License

This project is distributed under the MIT License.

Author

Zoraiz
GitHub: https://github.com/Zoraiz03