Skip to content

README.md

Latest commit

 

History

History
154 lines (114 loc) · 4.74 KB

README.md

File metadata and controls

154 lines (114 loc) · 4.74 KB

📱 Bangla Unit & Currency Converter

A versatile Flutter-based mobile application for seamless unit and currency conversions, designed with special focus on Bangladeshi users while being equally useful worldwide.

✨ Features

  • 🌍 Currency Conversion -- Convert between USD, BDT, and more with real-time exchange rates (requires internet connection).
  • 📏 Height Conversion -- Switch between feet, inches, centimeters, and meters effortlessly.
  • ⚖️ Weight Conversion -- Convert kilograms, pounds, and ounces instantly.
  • 🌡️ Temperature Conversion -- Accurate conversions between Celsius and Fahrenheit.
  • ⏱️ Time Conversion -- Convert between hours, minutes, and seconds with ease.
  • 🈯 Bilingual Support -- Available in English and Bangla for a localized experience.
  • 🎨 Adaptive Themes -- Enjoy both dark and light modes for comfortable usage.
  • 🚫 Non-Intrusive Ads -- Minimal banner ads for a clean experience, with an option to remove all ads via a one-time purchase.

📸 Screenshots

Home (Light Mode) Home (Dark Mode)
Currency Conversion Height Conversion Weight Conversion
Temperature Conversion Time Conversion
Bilingual Support Adaptive Themes Non Intrusive Ads

⚙️ Prerequisites

Before installing and running the app, make sure you have:

  • ✅ Flutter SDK (latest stable version recommended)
  • ✅ Dart (comes bundled with Flutter)
  • ✅ Android Studio or VS Code with Flutter & Dart plugins installed
  • ✅ A device/emulator (Android)
  • ✅ Internet connection (required for real-time currency conversion)
  • ✅ Git (for cloning the repository)

Optional (for contributors)

🚀 Installation

  1. Clone the repository:

    git clone https://github.com/Nyctophilia58/bangla_unit_currency_converter.git

  2. Navigate to the project directory:

    cd bangla_unit_currency_converter

  3. Install Flutter if not already installed -- Flutter Installation Guide

  4. Install dependencies:

    flutter pub get

  5. Run the app on an emulator or device:

    • Android:

      flutter run

    • iOS:

      flutter run

      (ensure Xcode is properly set up)

📖 Usage

  1. Select the conversion type from the home screen.
  2. Enter your value using the on-screen keypad.
  3. Choose the input and output units from the dropdown menus.
  4. Tap OK to view the converted result.

🤝 Contributing

Contributions are always welcome!

🔄 Pull Request Process

  1. Fork the repository.

  2. Create a new branch for your feature or fix:

    git checkout -b feature/your-feature-name

  3. Commit your changes with clear messages:

    git commit -m "Add: short description of feature/fix"

  4. Push the branch:

    git push origin feature/your-feature-name

  5. Open a Pull Request with:

    • A clear description of the problem and solution.
    • Screenshots or logs if relevant.
    • Reference to any related issues.

Please make sure your code:

  • Follows the project's coding style.

  • Passes Flutter analyzer checks:

    flutter analyze

  • Builds successfully before submission.

📬 Contact

For questions, suggestions, or support: