Skip to content

Harsh-26626/congenial-carnival

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 

Repository files navigation

💱Universal Currency Converter

A simple Flutter app that converts between different world currencies using live exchange rates.

Built with Flutter’s Material UI, HTTP networking, and dropdown menus for smooth user experience.


✨ Features

  • 🔄 Convert between 100+ currencies (USD, INR, EUR, JPY, and many more)

  • ⌨️ Clean input field with validation

  • 📱 Modern Material UI design with dropdown menus

  • 🌐 Live rates fetched from ExchangeRate API

  • 🎨 Dark-themed interface


📸 Screenshots

Screenshot 2025-09-14 141730 Screenshot 2025-09-14 141816 Screenshot 2025-09-14 141844


🛠️ Tech Stack

  • Flutter (Dart)

  • HTTP package for API requests

  • ExchangeRate API for live rates


⚙️ Setup & Installation

  1. Clone the repo
git clone https://github.com/harsh-26626/congenial-canival.git

cd congenial-canival
  1. Change branch to master
git checkout master
  1. Install dependencies
flutter pub get
  1. Get an API key
  • Follow these steps to get your API key:
  1. Run the app
  • Option A: With .env (local development)
    1. Create a .env file in the root:
      API_KEY=your_api_key_here
      
    2. Load it using flutter_dotenv
  • Option B: With --dart-define (production / builds)
    1. Pass the key at runtime:
      flutter run --dart-define=API_KEY=your_api_key_here
      

📂 Project Structure

lib/
 └── currency_converter.dart   # Main app widget
pubspec.yaml                  # Dependencies & metadata
.env                          # API key (local only, don’t commit!)

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published