Skip to content

A sleek currency converter that lets you enter an amount, pick currencies with flag icons ๐Ÿ‡บ๐Ÿ‡ธโžก๏ธ๐Ÿ‡ฎ๐Ÿ‡ณ, use the flip button ๐Ÿ”, and get instant exchange rates. Features a glass-effect UI with smooth and accurate conversions.

Notifications You must be signed in to change notification settings

chkrishnaa/Currency-Converter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

38 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ Currency Converter App

This currency converter app provides a clean and modern interface that makes converting money between different countries simple and intuitive. At the top, users can enter the amount they want to convert, followed by two dropdown menusโ€”one for the source currency and one for the target currency. Each dropdown is enhanced with a country flag icon ๐Ÿ‡บ๐Ÿ‡ธ๐Ÿ‡ฎ๐Ÿ‡ณ, making it easier to quickly recognize currencies at a glance. The center also includes a swap/flip button ๐Ÿ”, allowing users to instantly reverse the currency direction without manually changing both fields.

Once the currencies and amount are selected, users can tap the โ€œGet Exchange Rateโ€ button to fetch the latest conversion value. The result appears neatly below, showing the exact conversion in a clear and bold formatโ€”e.g., 100 USD = 9002.51 INR. The overall design combines a glassy card effect with a futuristic background, creating a stylish and user-friendly experience. The interface not only looks visually appealing but also ensures smooth usability for anyone who wants quick and accurate currency conversions.


๐Ÿ–ผ๏ธ Sample Screenshot:

This is a sample screenshot showing how the website looks

Screenshot 1


๐ŸŽฅ Demo Video:

Demo Video


โœจ Features:

  • Convert any amount between global currencies.
  • Flag-based currency dropdowns for better identification.
  • Swap/flip button to reverse currency direction instantly.
  • Real-time conversion using Exchange Rate API.
  • Glass-effect UI with futuristic design.
  • Responsive layout for mobile and desktop.
  • Fast performance with React + Vite.

๐Ÿ› ๏ธ Tech Stack:

Frontend:

React Vite JavaScript

Styling:

CSS3

API:

Exchange Rate API Flags API


๐Ÿ“ Folder Structure:

Currency-Converter
โ”œโ”€โ”€ public
โ”‚   โ”œโ”€โ”€ assets
โ”‚   โ”‚   โ”œโ”€โ”€ image1.png
โ”‚   โ”‚   โ”œโ”€โ”€ image2.png
โ”œโ”€โ”€ src
โ”‚   โ”œโ”€โ”€ components
โ”‚   โ”‚   โ”œโ”€โ”€ ConverterForm.jsx
โ”‚   โ”‚   โ”œโ”€โ”€ CurrencySelect.jsx
โ”‚   โ”œโ”€โ”€ App.jsx
โ”‚   โ”œโ”€โ”€ index.css
โ”‚   โ”œโ”€โ”€ main.jsx
โ”œโ”€โ”€ index.html
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ vite.config.js
โ”œโ”€โ”€ README.md

๐Ÿš€ Getting Started:

Follow the steps below to run this project locally.

1. Clone the repository:

git clone https://github.com/chkrishnaa/Currency-Converter.git

2. Navigate into the project directory:

cd Currency-Converter

3. Install dependencies:

npm install

4. Get your Exchange Rate API key:

4(a) Go to the website:

Exchange Rate API

4(b) Create a free account:

Click "Get Free API Key"

4(c) Copy your API key:

After signup, the dashboard will show your key and their request that are hide in red boxes given below. You didnt need to copy the request URL. Noly need to copy the API key written in Hexademical format. Screenshot 2

5. Create a .env file in your project root directory:

Create a .env file in your root directory and then you folder structure becomes:

Currency-Converter
โ”œโ”€โ”€ public
โ”‚   โ”œโ”€โ”€ assets
โ”‚   โ”‚   โ”œโ”€โ”€ image1.png
โ”‚   โ”‚   โ”œโ”€โ”€ image2.png
โ”œโ”€โ”€ src
โ”‚   โ”œโ”€โ”€ components
โ”‚   โ”‚   โ”œโ”€โ”€ ConverterForm.jsx
โ”‚   โ”‚   โ”œโ”€โ”€ CurrencySelect.jsx
โ”‚   โ”œโ”€โ”€ App.jsx
โ”‚   โ”œโ”€โ”€ index.css
โ”‚   โ”œโ”€โ”€ main.jsx
โ”œโ”€โ”€ .env                    ### .env file is created
โ”œโ”€โ”€ index.html
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ vite.config.js
โ”œโ”€โ”€ README.md

Now paste your Exchange Rate API Key in this .env file:

VITE_EXCHANGE_RATE_API_KEY=your_api_key_here

6. Start development server:

npm run dev

Your app will run at:

http://localhost:5173

7. If you want to build for production deployment ๐Ÿ“ฆ

npm run build

About

A sleek currency converter that lets you enter an amount, pick currencies with flag icons ๐Ÿ‡บ๐Ÿ‡ธโžก๏ธ๐Ÿ‡ฎ๐Ÿ‡ณ, use the flip button ๐Ÿ”, and get instant exchange rates. Features a glass-effect UI with smooth and accurate conversions.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published