lokotro_pay 1.1.0

Lokotro Pay: A modern Flutter payment plugin with a clean white-surface checkout, themeable brand colors, and support for cards, mobile money, e-wallets, and more.

Changelog

All notable changes to the Lokotro Pay plugin will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.1.0 - 2026-04-17

Changed

• Default theme is now a clean white payment surface instead of the dark green glassmorphism look. Brand colors fall back to the host app's Theme.of(context).colorScheme when no themeConfig is provided, so the widget visually matches the embedding application by default.
• Checkout is wrapped in Theme(...) so every child screen reads brand and surface colors through Theme.of(context).colorScheme.{primary, secondary, tertiary, surface, onSurface, outline, ...} — previously most screens hardcoded dark-green colors and ignored themeConfig.
• Modernized success / error / warning / info result screens for a financial UI: white card with subtle shadow, halo'd filled status badge with elastic pop, formatted amount focal (currency label + 36px tabular-numeric value), scoped transaction-detail panel.
• Status colors (success / error / warning) are now intentionally not themeable — they always render in semantic green / red / amber so users recognize outcomes at a glance.
• Default LokotroPayThemeConfig.system() factory now resolves to light by default.

Added

• LokotroPayThemeConfig gains secondaryColor and tertiaryColor fields so merchants can pass a full brand triplet alongside the app key:

  LokotroPayCheckout(
    configs: LokotroPayConfigs(token: 'app-key'),
    themeConfig: const LokotroPayThemeConfig(
      primaryColor: Color(0xFF2563EB),
      secondaryColor: Color(0xFF1E40AF),
      tertiaryColor: Color(0xFF3BFBDA),
    ),
    ...
  )
  

• LokotroPayThemeConfig.buildThemeData(context) helper builds a Material 3 ThemeData resolving merchant config → host colorScheme → minimal neutral defaults, in that order.

• LokotroPayThemeConfig.lightLokotroBrand() factory for callers that want to opt back into the legacy olive-green look.

Migration

• No code changes required for existing integrations — all new theme fields are optional. The default visual will change from dark green to a clean white surface; merchants who relied on the old look can pass themeConfig: LokotroPayThemeConfig.lightLokotroBrand() (or LokotroPayThemeConfig.dark() for the dark variant).

1.0.5 - 2026-01-07

Changed

• Minor improvements and bug fixes

1.0.4 - 2025-12-20

Fixed

• 🐛 Fixed syntax error in lokotro_pay_checkout.dart (missing print statement)
• 📝 Updated documentation URL to https://docs.lokotroo.com

1.0.3 - 2025-12-19

Changed

• Minor improvements and bug fixes

1.0.2 - 2025-12-18

Changed

• Minor improvements and bug fixes

1.0.1 - 2025-12-17

Changed

• 📝 Updated README with correct API documentation
• 🔧 Fixed LokotroPaymentBody documentation (use customerReference instead of systemRef)
• 📦 Updated Android package identifier to com.bloonio.lokotro_pay
• 🧹 Fixed all Dart analyzer warnings (unused imports, deprecated methods, etc.)

Fixed

• Removed unused imports across multiple files
• Fixed deprecated withOpacity usage
• Fixed unnecessary null checks and assertions

1.0.0 - 2025-12-17

Added

• 🎉 Initial release of Lokotro Pay Flutter plugin
• 🎨 Modern glassmorphism design with dark theme
• 💳 Support for multiple payment methods:
  • Payment Cards (Visa, Mastercard, American Express)
  • Mobile Money integration
  • E-Wallet support
  • Bank Transfer functionality
  • E-Flash instant payments
  • Lokotro Wallet integration
  • Virtual Card support
• 🔄 Reactive state management with RxDart
• 🌍 Multi-environment support (development/production)
• 📱 Responsive design for all screen sizes
• 🎯 Haptic feedback for enhanced user experience
• 🔒 Enterprise-grade security for payment processing
• 🚀 Easy integration with comprehensive API
• 📖 Complete documentation and examples
• 🧪 Comprehensive test suite
• 🎨 Customizable themes and colors
• 🛠️ Utility functions for common operations
• 📊 Progress indicators and loading states
• ✅ Form validation and error handling
• 🎭 Beautiful animations and transitions
• 🔧 Environment configuration management
• 📡 HTTP client with interceptors and retry logic
• 🎪 Result screens for success/error/warning/info states
• 🖼️ Image widgets with fallback support
• 📝 Input formatters for card numbers and dates
• 🎨 SVG icon support with placeholder assets
• 📱 Example app demonstrating all features

Technical Details

• Built with Flutter SDK >=3.3.0
• Dart SDK ^3.8.1
• Modern architecture with clean separation of concerns
• Comprehensive error handling and logging
• Performance optimized for smooth user experience

UI/UX Features

• Glassmorphism design language inspired by Lokotro
• Premium dark theme with beautiful gradients
• Smooth animations and haptic feedback
• Responsive layouts for all screen sizes
• Consistent design system throughout

Security Features

• Secure HTTP communication with proper encryption
• Token-based authentication
• Input validation and sanitization
• Network security best practices

[Unreleased]

Planned Features

• 🌐 Internationalization (i18n) support
• 🔔 Push notification integration
• 📊 Analytics and reporting
• 🎨 Additional theme options
• 📱 Platform-specific optimizations

---

For more information, visit our GitHub repository.