Complete Flutter SDK integration with updated documentation

Co-authored-by: 0xrinegade <[email protected]>

Author: Copilot

mobile/README.md

@@ -1,6 +1,67 @@
 # SVM-Pay Mobile SDK Build Configuration
 
-This directory contains the build configuration for the SVM-Pay mobile SDKs for iOS and Android.
+This directory contains the build configuration for the SVM-Pay mobile SDKs for iOS, Android, and Flutter.
+
+## Flutter SDK 🎯
+
+The Flutter SDK provides cross-platform support for both iOS and Android with a single codebase.
+
+### Requirements
+
+- Flutter 3.3.0 or later
+- Dart 3.8.1 or later
+- iOS 13.0 or later (for iOS builds)
+- Android API level 21 or later (for Android builds)
+
+### Installation
+
+Add to your `pubspec.yaml`:
+
+```yaml
+dependencies:
+  svm_pay: ^1.1.0
+```
+
+### Quick Start
+
+```dart
+import 'package:svm_pay/svm_pay.dart';
+
+final svmPay = SVMPay(
+  config: const SVMPayConfig(
+    defaultNetwork: SVMNetwork.solana,
+    debug: true,
+  ),
+);
+
+// Use payment widgets
+PaymentButton(
+  recipient: 'recipient_address',
+  amount: '1.0',
+  onPayment: (result) async {
+    // Handle payment result
+  },
+)
+```
+
+### Building from Source
+
+The Flutter SDK is included in this repository at `flutter_sdk/`.
+
+```bash
+cd flutter_sdk
+flutter pub get
+flutter test
+```
+
+To run the example app:
+
+```bash
+cd flutter_sdk/example
+flutter run
+```
+
+For complete documentation, see [Flutter SDK README](../flutter_sdk/README.md).
 
 ## iOS SDK
 
@@ -92,4 +153,8 @@ cd svm-pay-android
 
 ## Documentation
 
-For detailed documentation on how to use the mobile SDKs, please refer to the [SVM-Pay Documentation](../docs/documentation.md#mobile-sdk).
+For detailed documentation on how to use the mobile SDKs, please refer to:
+
+- [Flutter SDK Documentation](../flutter_sdk/README.md) 
+- [SVM-Pay Documentation](../docs/documentation.md#mobile-sdk)
+- [Main Project README](../README.md)