Currency Plus 💱

A modern, feature-rich currency converter app built with Flutter.

✨ Features

• 💱 30+ Currencies - Major world currencies (USD, EUR, GBP, JPY, SGD, AED, THB, and more)
• 🌐 Live Exchange Rates - Real-time rates via ExchangeRate-API
• 📴 Offline Support - Works without internet using cached rates
• ⌨️ Custom Numpad - Built-in calculator-style numpad, no phone keyboard
• 🔄 Multi-Currency View - Convert one amount to multiple currencies at once
• 📌 Reorderable - Drag to reorder currencies
• ➕ Add/Remove - Dynamically add or remove currencies
• 💾 State Persistence - Your preferences are saved automatically
• 🌙 Dark Mode - Full dark mode support
• 🎨 Material Design 3 - Clean, modern interface

📱 App Screen

🚀 Quick Start

# Clone the repository
git clone https://github.com/YOUR_USERNAME/currency_plus.git
cd currency_plus

# Install dependencies
flutter pub get

# Configure API key (see SETUP.md)
cp lib/config/api_config.example.dart lib/config/api_config.dart
# Edit api_config.dart and add your API key

# Run the app
flutter run

# Build APK
./build_apk.sh

📖 See SETUP.md for detailed installation and configuration instructions.

🎯 Usage

• Add Currency: Tap "Add currency" button
• Remove Currency: Tap the red ⊖ icon
• Reorder: Long-press ☰ handle and drag
• Enter Amount: Tap any currency field and use the numpad
• Clear: Tap red C button
• Delete: Tap orange ⌫ button

🛠️ Built With

• Flutter - UI framework
• ExchangeRate-API - Exchange rate data
• Provider - State management
• SharedPreferences - Local storage

📋 Requirements

• Flutter 3.38.0+
• Dart 3.10.0+
• Android SDK (for Android) or Xcode (for iOS)

🔑 API Setup

1. Get a free API key from ExchangeRate-API (1,500 requests/month)
2. Copy lib/config/api_config.example.dart to lib/config/api_config.dart
3. Add your API key
4. Set useDemoMode = false

Note: App works offline with cached rates if no API key is configured.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• ExchangeRate-API for providing free exchange rate data
• Flutter team for the amazing framework
• All contributors and users of this project

📞 Support

For issues, questions, or suggestions:

• 🐛 Report a Bug
• 💡 Request a Feature
• 📖 Read the Docs

---

Made with ❤️ using Flutter