Skip to content

Louay-Barraq/Converti

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Converti - Currency Converter App

A beautiful and intuitive Flutter application for real-time currency conversion. Convert between multiple currencies with up-to-date exchange rates, featuring a modern UI with theme customization and multi-language support.

🌟 Features

  • Real-time Currency Conversion - Convert between 150+ currencies with live exchange rates
  • Beautiful UI - Clean, modern interface with smooth animations
  • Dark/Light Theme - Switch between light and dark modes
  • Multi-language Support - Available in multiple languages
  • Offline Currency List - View currency information even without internet
  • Decimal Precision Control - Configure decimal places for conversions
  • Cross-platform - Runs on Android, iOS, Web, and Desktop

🚀 Getting Started

Prerequisites

  • Flutter SDK (version 3.0 or higher)
  • Dart SDK (included with Flutter)
  • Android Studio or VS Code with Flutter extensions
  • For Android: Android SDK and Android Virtual Device (AVD)
  • For iOS: Xcode (macOS only)

Installation

  1. Clone the repository

    git clone https://github.com/your-username/converti.git
    cd converti
  2. Install dependencies

    flutter pub get
  3. Check Flutter setup

    flutter doctor

    Ensure all required components are installed and configured.

  4. Run the app

    For Android:

    flutter run

    For iOS:

    flutter run -d ios

    For Web:

    flutter run -d web

    For Desktop:

    flutter run -d windows    # Windows
    flutter run -d macos      # macOS
    flutter run -d linux      # Linux

Building the App

Release APK for Android:

flutter build apk --release

Release Build for iOS:

flutter build ios --release

Web Build:

flutter build web

🏗️ Project Structure

lib/
├── data/           # Data repositories and currency definitions
├── models/         # Data models (Currency, etc.)
├── providers/      # State management providers
├── screens/        # UI screens (Converter, Settings)
└── main.dart       # App entry point

🛠️ Technologies Used

  • Flutter - Cross-platform UI framework
  • Provider - State management
  • SharedPreferences - Local storage
  • Flutter Localizations - Internationalization
  • HTTP - API calls for exchange rates

📋 Future Improvements

  • Historical Exchange Rates - View currency conversion history
  • Currency Charts - Visual representations of exchange rate trends
  • Offline Mode - Cache exchange rates for offline use
  • Calculator Mode - Built-in calculator for complex conversions
  • Currency Alerts - Notifications for rate changes
  • Portfolio Tracking - Track currency holdings
  • More Themes - Additional color themes and customizations
  • Widgets - Home screen widgets for quick conversion
  • Apple Watch/Android Wear Support - Companion watch app
  • Biometric Authentication - Secure access to app settings
  • Export History - Export conversion history to CSV/Excel
  • Advanced Search - Search currencies by name or code
  • Favorites - Quick access to frequently used currencies

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

  1. Fork the repository
  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

📞 Support

If you have any questions or need support, feel free to:

  • Open an issue on GitHub
  • Contact the development team (Me)

Made with ❤️ using Flutter

About

A mobile application for currency conversion between different currencies from all over the world.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors