🚀 OvoPay – The ultimate Cross-Platform MFS Solution with User, Agent & Merchant Mobile Apps, seamlessly integrated with a Web Platform & Admin Panel. Easily manage digital transactions, virtual cards, and payments while ensuring top-notch security and scalability. With multi-layer authentication, real-time notifications, and extensive payment gateway support, OvoPay delivers a feature-packed, future-ready MFS Solution for businesses of all sizes. 🔥

Thank you for choosing OvoPay If you have any questions not covered in this documentation, please feel free to reach out to us via email. We’re here to assist and will respond as promptly as possible. Thank you again!

• Flutter SDK (latest stable version-> 3.29.2 - Latest)
• Dart SDK (bundled with Flutter SDK-> 3.7.2 - Latest)
• Android Studio (for Android development-> Meerkat | 2024.3.2 - Latest)
• Xcode (for iOS development-> 16)
• Android Studio (Recommended IDEs)
• Java JDK 19 or later (for Android builds)
• Internet connection (for package and plugin downloads)
• Sufficient storage (at least 10GB free space)
• Minimum 8GB RAM (16GB recommended)

Installation Steps:

1. Download and Install Flutter: Visit the official Flutter installation page for the latest version and platform-specific setup instructions. Follow the guidelines for your operating system (Windows, macOS, or Linux) to complete the installation.
2. Set Up Android Studio: Android Studio is required for developing and running Flutter apps on Android. Visit the official Android Studio download page and install the latest version. During setup, ensure that you install the Android SDK and configure the necessary environment variables for Flutter development.
3. Verify Flutter Installation: After installing both Flutter and Android Studio, open a terminal or command prompt and run flutter doctor to check if everything is set up correctly. This command will display any missing dependencies or configurations needed for development.
4. Connect a Device or Set Up an Emulator: Connect your Android device via USB or set up an Android emulator in Android Studio to test your app.

• The assets folder contains all essential assets such as images and fonts. This is the folder to use if you need to add or update any images or custom fonts.


• The lib folder is the main directory for all Dart code in the application. It is typically organized into subfolders such as core for utility files and dependencies, data for managing API calls and local data sources, and view for UI components and screens.


• The main.dart file is the entry point of the Flutter application where the app's root widget and initial setup are defined.

• For Android:
  • Open the Android project in Android Studio.
  • Update the package name in the `AndroidManifest.xml` file located at android/app/src/main/AndroidManifest.xml.
  
• For iOS:
  • Update the bundle identifier in the `Info.plist` file located at ios/Runner/Info.plist.
  

• For Android:
  • Prepare the icon images in various sizes (e.g., 48x48, 72x72, etc.).
  • Navigate to the `res` directory at android/app/src/main/res/.
  • Replace the default icons in the `mipmap-*` directories with your new app icon files (e.g., mipmap-hdpi/ic_launcher.png).
  • Ensure that you follow the required naming conventions for different densities (e.g., `mipmap-mdpi`, `mipmap-hdpi`, `mipmap-xhdpi`, etc.).
  • Update the icon in the AndroidManifest.xml file if necessary.
  
• For iOS:
  • Prepare the app icon images in multiple sizes (e.g., 60x60, 120x120, 180x180, etc.).
  • Open the iOS project in Xcode.
  • Navigate to the Assets.xcassets folder in the project navigator.
  • Find the `AppIcon` set and drag your new icon images into the appropriate boxes for different sizes (e.g., 60pt, 120pt, etc.).
  • Ensure that the icon set includes all required sizes for both iPhone and iPad.
  

The app's strings are managed in the file located at: lib/core/utils/my_strings.dart.

• Open my_strings.dart in your preferred code editor.
• Locate the string constants, which are typically organized for each screen or feature.
• Edit the text values as needed, and save the file to apply your changes throughout the app.
• Ensure you rebuild the app if required to see updates in the app UI.
• Onboarding strings can also be edited in this file.

• For Both Android and iOS:
  • Open the `lib` directory of your Flutter project.
  • Locate the file that manages your network configurations (e.g., lib\environment.dart).
  • In this file, define the domain URL for your API requests (e.g.,
    static const String LIVE_API_URL = 'https://yourapi.com';
static const String TEST_API_URL = 'https://yourapi.com';).
  • Ensure all network calls use this base URL for making API requests throughout the app.
  

• For Both Android and iOS:
  • Open the `lib` directory of your Flutter project.
  • Navigate to your utils folder (e.g., lib\core\utils\my_color.dart).
  

• For Android:
  • Open the Android project in Android Studio.
  • Right click on project folder and click on Replace in Files
  
• Search com.ovosolution.ovopayagent in the first indicated box and your own package name in the second marked box. Then click Replace All button

The app's environment configuration is stored in the file located at: lib/environment.dart.

• Open environment.dart in your preferred code editor.
• Locate the environment variables section where you define different variables for various environments.
• Set the values for each environment by modifying the respective key-value pairs in the file.
• Ensure you rebuild the app after making changes to the environment file to apply the new configuration.

• Step 1: Add Your Logo to the Assets Directory
  • Create a folder inside the `assets` directory, called `images/logo`.
  • Place your logo image files inside the `assets/images/logo` folder. For example: - `assets/images/logo/logo.png` - You can also include other formats like `.jpg`, `.jpeg`, or `.svg` depending on your preference.

To change the onboard images for your app, follow these steps:

• Go to the assets/images/onboard directory in your Flutter project.
• Replace the existing images with the new images you want to use for onboarding.
• Ensure the new images follow the same naming convention and dimensions as the old ones. For example:
  onboard_1.png
  onboard_2.png
  onboard_3.png
• If needed, update the paths in the code where the images are used, such as in the onboarding screen widget.
• Don't forget to run flutter pub get to update the assets configuration.

• Follow the official Firebase documentation to add Firebase to your Flutter app:
  • Official Firebase Flutter Setup Guide
• Step 1: Install Node.js and npm:
  • First, ensure you have Node.js and npm installed. If not, follow these steps:
    • Download Node.js
    • After installation, verify if Node.js and npm are installed by running:
      node -v
      npm -v
• Step 2: Install Firebase CLI:
  • Install the Firebase CLI globally using npm:
    npm install -g firebase-tools
  • After installation, verify if Firebase CLI is installed by running:
    firebase --version
  • Log in to Firebase using your Google account:
    firebase login
• Step 3: Install FlutterFire CLI:
  • Install the `flutterfire_cli` tool globally using the following command:
    dart pub global activate flutterfire_cli
  • Ensure the `dart pub global` bin directory is in your PATH. You can check if the tool is installed by running:
    flutterfire --version
• Step 4: Configure Firebase for Your Flutter Project:
  • Run the following command to configure Firebase in your Flutter project:
    flutterfire configure --project=your-firebase-project-id
  • This command will automatically download the necessary configuration files (`google-services.json` for Android and `GoogleService-Info.plist` for iOS), modify the `pubspec.yaml` to include the required dependencies, and set up Firebase services.

Email Us: [email protected]