OvoSale is a complete cross-platform POS solution designed to streamline business operations across multiple platforms. With dedicated mobile apps, a responsive web interface, and a PWA for seamless desktop usage, OvoSale offers a robust and feature-rich system for managing sales, inventory, purchases, reports, customers, suppliers, transactions, and human resources (HRM) effortlessly. Whether you run a retail store, a supermarket, or a small business, OvoSale equips you with the essential tools to enhance efficiency, manage your team, improve customer experience, and drive business growth.

Thank you for choosing OvoSale 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.32.8)
• Dart SDK (bundled with Flutter SDK-> 3.8.1)
• Android Studio (for Android development-> Narwhal | 2025.1.1))
• 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.

• 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.
  • Update the applicationId in the android/app/build.gradle file:
  defaultConfig { applicationId "com.ovosolution.ovosale" }
  • Right click on project folder and click on Replace in Files
  
• Search com.ovosolution.ovosale in the first indicated box and your own package name in the second marked box. Then click Replace All button

• 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.

Email Us: [email protected]