Skip to content

README.md

Latest commit

 

History

History
100 lines (62 loc) · 2.66 KB

README.md

File metadata and controls

100 lines (62 loc) · 2.66 KB
Error in user YAML: (<unknown>): did not find expected alphabetic or numeric character while scanning an alias at line 3 column 1
---

# 💱 Currency Converter & Financial Dashboard

**A modern, real-time currency conversion tool with historical trend analysis.**

---

🚀 Live Demo

👉 Visit the Live Application

📜 About The Project

Currency Converter is a high-performance financial tool designed to provide users with more than just simple exchange rates. It integrates real-time data fetching with visual analytics to help users understand market trends.

Designed with a Glassmorphism UI, it ensures a seamless and visually appealing experience across all devices, making complex financial data easy to read and understand.

Key Features

  • ⚡ Real-Time Conversion: Instant currency exchange calculations with live API data.
  • 📈 Historical Trends: Interactive 7-day history chart using Chart.js to visualize market fluctuations.
  • 🔄 Smart Swap: Quickly reverse source and target currencies with a single click.
  • 🌍 Popular Rates: Quick-glance cards displaying major global currency pairs (USD, EUR, GBP, INR).
  • 🎨 Modern UI/UX: Built with Tailwind CSS featuring glassmorphism effects and dynamic country flags.
  • 📱 Fully Responsive: Optimized layout that works perfectly on mobile, tablet, and desktop.

🛠️ Tech Stack

  • Framework: React + Vite
  • Styling: Tailwind CSS
  • Charts: Chart.js (react-chartjs-2)
  • Icons: Lucide React
  • API: Exchange Rate API
  • Deployment: Vercel

💻 Getting Started (Local Development)

Follow these steps to run the project on your local machine:

  1. Clone the repository
git clone https://github.com/atharvachavan289-gif/currency-converter.git
  1. Navigate to the project folder
cd currency-converter
  1. Install dependencies
npm install
  1. Start the development server
npm run dev
  1. Open your browser Visit http://localhost:5173 (or the port shown in terminal) to view the app.

🤝 Contributing

Contributions are welcome! If you'd like to add new features like Dark Mode or Crypto support:

  1. Fork the Project.
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
  3. Commit your Changes (git commit -m 'Add some AmazingFeature').
  4. Push to the Branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.

👤 Author

Atharva Chavan

Built with ❤️ using React & Tailwind CSS