Welcome

We sincerely thank you for purchasing our product on CodeCanyon. Your trust in our offering is highly valued.

• Version: 1.0.0
• Author: ZumaCart
• Created: 19 August 2025
• Updated: 30 August 2025

If you have any questions not addressed in this help file, please feel free to reach out to us via the Item Support Page.

System Requirements

The required specifications for the Admin Panel:

• PHP Version: 8.2.x
• MySQL Version: 8.x
• Laravel Version: 12.x
• Composer Version: 2.7.x

The required specifications for the Flutter App:

• Flutter SDK: 3.35.0
• Dart Version: 3.9.0
• Android SDK: 35.0.0

Suggested Server

Installation for Admin Panel + Web

VPS Installation with Nginx, PHP, and MySQL

This guide covers a manual installation on a Virtual Private Server (VPS) for users who prefer full control over their server environment. This process is for a fresh Ubuntu/Debian installation.

1. Connect to your VPS via SSH.
2. Install Nginx, PHP 8.2 FPM, and MySQL server.
3. Configure Nginx with a new server block for your domain.
4. Create a new MySQL database and user.
5. Upload the ZumaCart project files to your server's web root (e.g., /var/www/your_domain.com).
6. Open your terminal in the project directory and run npm install to install front-end dependencies.
7. Navigate to your domain in a web browser to begin the web-based installation.
8. Fill in the database credentials and other details to finalize the setup.

Flutter Mobile App Installation

Prerequisites

Download the latest version of Android Studio for Windows from the official site here: Download Android Studio.

1. Installing & Configuring Android Studio

First, download Android Studio. During installation, set the directory to C:\Users\User\Android\AndroidStudio. Avoid spaces in the path. You'll also need to install the Android SDKs. In the SDK Manager, ensure you select the required options.

2. Installing & Configuring Flutter SDK

Download the latest Flutter SDK from the official site. After downloading, extract the folder named flutter to a directory without spaces, such as C:\Users\User\flutter. Run the command flutter --version to verify installation. Then run flutter doctor to check for necessary dependencies. If you encounter "Android SDK Licenses" issues, run the command flutter doctor --android-licenses to accept the necessary SDK licenses.

Flutter Project Run

1. Download and Extract the Project

Download the package from your Codecanyon account and extract the files to a preferred location.

2. Set Up Your Development Environment

Install Flutter and Dart, and configure your IDE (Android Studio, VS Code, or IntelliJ IDEA) by installing the Flutter and Dart plugins.

3. Open the Project

Launch your IDE and use the Open or Import Project option to open the folder where you extracted the project.

4. Configure the Project

• Change the Domain: Search all files for demo.zumacart.com and replace it with your own domain.
• Change the App Name (Display Name):
  • Android: Open android/app/src/main/AndroidManifest.xml and update android:label="Your App Name".
  • iOS: Open ios/Runner/Info.plist and update the value for CFBundleDisplayName.
• Generate App Icons: After adding your icon image to the project, run:

flutter pub run flutter_launcher_icons:main

5. Install Dependencies

Open the terminal in the project directory and run:

flutter pub get

6. Set Up Emulator or Device

Start an Android Virtual Device (AVD) from Android Studio's AVD Manager, or an iOS Simulator (macOS only) from Xcode. Alternatively, connect a real device via USB.

7. Run the App

Ensure your emulator/device is connected and running, then run:

flutter run

8. Build the App for Release

For Android, run:

flutter build apk --release

For iOS, run:

flutter build ios --release

Firebase CLI Quick Setup

Step 1: Create a Firebase Project

Open Firebase Console and create a new project. Remember to change the package name for Android and the bundle identifier for iOS in your app before configuring Firebase.

Installation

Install Firebase CLI and FlutterFire CLI using these commands:

npm install -g firebase-tools

dart pub global activate flutterfire_cli

Usage: Initialize Firebase

Run the configuration command in the root of your Flutter application and follow the prompts:

flutterfire configure

How to Publish Your Android App on the Play Store

Step 1 – Google Play Console Developer Account.

Create an account which requires a one-time fee of $25. The account activation process may take up to 48 hours.

Step 2 – Set-up up a Google Merchant Account.

If your app includes in-app purchases, link your developer account to a Google Merchant Account.

Step 3 – Create Application

From the Menu > All applications, select 'Create Application' and fill in the basic details like app name, language, and whether it's free or paid.

Step 4. App Store Listing Details

Provide a short and full description, upload app graphics (screenshots, icon), select a category, and add a privacy policy. Ensure your content rating questionnaire is completed to avoid being classified as 'Unrated'.

Step 6 – Create & Upload Android App to Google Play

Choose your release type (Internal, Closed, Open, or Production) and upload your app bundle. Go to 'App Releases', select 'Manage Production', and 'Start rollout to production'.

ZumaCart: Publish Your App to the Apple App Store

Apple Developer Account

Join the Apple Developer Program and pay the $99/year membership fee.

Create a Bundle Identifier

Create a unique ID for your app in reverse DNS format (e.g., com.example.appname) in both your project settings and your Apple Developer account.

Add A New App To App Store Connect

Go to App Store Connect, select 'Apps', click the '+' button, and enter your app's information. Be sure to select the Bundle ID you created earlier.

Generate Your App Store Connect API Key

Generate an API Key with 'App Manager' access from the 'Users and Access' section in App Store Connect. Download the key file and add it to your project settings.

Add Your Issuer ID, Key ID, and App Store App ID To Your Project

Copy the Issuer ID, Key ID, and Apple ID from App Store Connect and paste them into the corresponding fields in your project settings.