Skip to content

A simple and responsive currency converter built with React. Converts between currencies using real-time exchange rates from a public API.

Notifications You must be signed in to change notification settings

MrAkbari91/Currency-Converter-React

Repository files navigation

Currency Converter

A simple, modern currency converter web application built with React and Vite. Instantly convert between currencies using live exchange rates, with a clean UI and dark mode support.

🚀 Features

  • Real-time currency conversion using @fawazahmed0/currency-api
  • Swap between currencies with one click
  • Responsive design with Tailwind CSS
  • Dark mode toggle
  • Built with React Router for navigation

🛠️ Technologies & Dependencies

📦 Setup & Installation

  1. Clone the repository:

    git clone https://github.com/MrAkbari91/currency-converter.git
    cd currency-converter
  2. Install dependencies:

    Using npm:

    npm install

    Using yarn:

    yarn install

    Using bun:

    bun install
  3. Start the development server:

    Using npm:

    npm run dev

    Using yarn:

    yarn dev

    Using bun:

    bun run dev
  4. Open in your browser: Visit http://localhost:5173 (or the port shown in your terminal).

💡 How It Works

  • Enter an amount and select the source and target currencies.
  • Click "Convert" to see the converted value using the latest exchange rates.
  • Use the "swap" button to quickly switch between source and target currencies.
  • Toggle dark mode using the moon/sun icon in the header.

📝 Usage

This project is ideal for anyone needing quick, accurate currency conversions in a modern web interface.

🤝 Contributing

This project is open source! Contributions, issues, and feature requests are welcome.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/YourFeature)
  3. Commit your changes (git commit -m 'Add some feature')
  4. Push to the branch (git push origin feature/YourFeature)
  5. Open a pull request

Made with ❤️ by Dhruv Akbari

About

A simple and responsive currency converter built with React. Converts between currencies using real-time exchange rates from a public API.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published