CartUser Seller App

Welcome to the Seller App documentation for CartUser. This guide will help you set up, customize, and release your Seller App built with Flutter.

Flutter Setup

  1. To install Flutter, visit this website and follow the platform-specific instructions.
  2. Download Android Studio.
  3. After installing, open Android Studio and select More Action or the three dots in the top corner. Then select SDK ManagerAndroid SDK / Sdk Tools. Click Android SDK Command-line Tools (latest) and then apply. It will start downloading the tool.

After download is completed, go to Android Studio plugins section and install Dart & Flutter plugins.

Now run this command in your terminal: flutter doctor

You might need to run flutter doctor --android-licenses if this is your first Flutter installation.

An ideal output will be something like this (marked sections must have a checkmark):

If this does not work, follow the guide on the official website.

Change Base URL

Use your admin URL as the base URL. First, you have to install your admin panel. For example, if your admin URL is https://your_domain.com/admin, then the base URL will be https://your_domain.com (without the /admin). Add it at the end, so the final URL will be https://your_domain.com.

Open [project]/lib/_core/strings/endpoints.dart and replace the baseUrl value with your own URL.

Remember! Don’t put a slash (/) at the end of your base URL.

App Appearance

Change App Logo

  1. Place your logo in the [PROJECT]/assets/icon/ folder.
  2. The logo name should be app_logo.png.
  3. Run dart run flutter_launcher_icons in the terminal.

Change App Name

  1. Activate rename by running flutter pub global activate rename.
  2. Change the app name by running:
    rename setAppName --targets ios,android --value "Your App Name"
  3. Change the app Bundle/Package ID by running:
    rename setBundleId --targets ios,android --value "com.example.bundleId"
The Bundle ID and Package Name are unique identifiers, chosen by you. They can never be the same for two applications inside the Apple App Store or Google Play Store. The format for a Bundle ID is com.company.app.
Note: Do not use hyphens (-), underscores (_), spaces ( ), or you might run into errors. Also, all characters should be lowercase.

Firebase Config

Create Firebase Project and App

  1. Go to the Firebase console and create a project.
  2. From the Project overview, select the Flutter app.
  1. Install Firebase CLI. You might need to restart the terminal after installation.
  1. To log in to your Firebase account from the terminal, run: firebase login.
  2. Install FlutterFire CLI:
    1. Run dart pub global activate flutterfire_cli.
    2. Run flutterfire configure --project=your_project_name.

This will create the following files:

  • firebase_options.dart file in the lib directory.
  • google_services.json file in the android/app directory.
  • GoogleService-Info.plist file in the ios/Runner directory.

Enabling Firebase in Your Project

To enable Firebase integration in your project, follow these steps:

  • Navigate to lib/main.dart.
  • Locate the following line of code:
    ///* To enable FIREBASE, change the value to true;
  • By default, the line
    FireMessage.isFireActive = false;
    indicates that Firebase is not active. Once you have configured Firebase from the Firebase Console, set the value to true like so:
    FireMessage.isFireActive = true;

Create Firebase Json Key

Firebase Cloud Messaging Configuration Steps

  1. Go to the Firebase console and open the Cloud Messaging tab in project settings.
  2. Click on Manage Service Accounts.
  3. Ensure the correct project is selected from the dropdown menu.
  4. Click Create Service Account.
  5. Fill in the details and continue to the next step.
  6. Click the role dropdown box, search for firebase admin, and select it.
  7. Continue to the next step and press Done.
  8. This will create a new service account. Click the three dots next to the account and select Manage keys.
  9. Select Add key, then select Create New Key. Choose JSON from the popup dialog and hit Create.
  10. This will download a JSON file. Open the file and copy its contents.
  11. Paste the content into the firebase json config field in the admin panel.

App Build & Release

Create an Upload Keystore

To create a keystore, run the following command at the command line:

On macOS or Linux, use the following command:

keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

On Windows, use the following command in PowerShell:

keytool -genkey -v -keystore $env:USERPROFILE\upload-keystore.jks -storetype JKS -keyalg RSA -keysize 2048 -validity 10000 -alias upload

This command stores the upload-keystore.jks file in your home directory.

Note: When creating a keystore file, it will ask for some details, a keyPassword, and a storePassword. Use the same password for both and write it down somewhere. We will need this later.
Note: Keep the upload-keystore.jks and its passwords private. Don’t check them into public source control!
  1. Move the upload-keystore.jks file to [project]/android/app/ folder for easy management.
  2. Edit the key.properties file in [project]/android/ and update the storePassword and keyPassword values:
				        		
				        			storePassword=YOUR_PASSWORD
									keyPassword=YOUR_PASSWORD
									keyAlias=upload
									storeFile=upload-keystore.jks
								
							
  1. Run flutter clean && flutter pub get in the terminal.

Debug the App

  1. Open the project in Android Studio and run the app in debug mode.
  2. You can use an Emulator from Android Studio or connect a physical device.

Build for Android

  1. For a release build, run the command: flutter build apk.
  2. The build file location: [project]/build/app/outputs/flutter_apk/release/app-release.apk.
  3. For deployment, please follow this documentation.

Build for iOS

Follow this guide to build and release the iOS app.

Pre-requisites for iOS

  • A valid Apple developer account
  • A device that can run Xcode
To demo the iOS app, run the app in debug mode using an Xcode iOS simulator.

Seller App Usages

This section covers the procedures for user registration, login, and password reset within the CartUser Seller App, as well as the workflow and processes involved in the Seller App.

Registration

Details on how users can register for a new account in the CartUser Seller App.

Registering as a new seller on your eCommerce platform is straightforward. Simply provide a username, email, and password, then subscribe to the service. After registration, you can upload your products and start selling through the platform to earn money.

Login

Instructions for users to log into their accounts in the CartUser Seller App.

Password Reset

Steps to reset a forgotten password in the CartUser Seller App.

Seller Shop/Store/Profile Config

Seller can manage his brand logo name and cover photo from the seller app, app ui screenshot given below for the referance.

Seller Product Manage

    • 1. Add Product: Click on the "Add Product" option (marked as 1) to open the product addition form (marked as 2). Fill out this form to add your product.
    • 2. Product Info: Complete this form with the product information, including images, and publish your product by submitting the form.
    • 3. Product Details: View the published product by clicking on the product title or image.
    • 4. Add Digital Product: Follow the same process as adding a physical product.
    • 5. Choose Product Type: Select the type of product from the available options.
    • 6. Campaign: Manage your campaign products from this section.
    • 7. Edit Product: Edit a product by clicking the edit icon on the product image.

Seller Withdraw Manage

In the screenshot, sections marked 1, 2, and 3 are related to withdrawal management. First, you need to set up the withdrawal method (marked as 1) to receive the balance from your sold items from the admin. Section 2 displays the withdrawal list, and section 3 shows the transaction log.

Seller Order Manage

Section marked 4 is for the order list, where you can manage orders and monitor their status. Sellers can also update the order status in this section.

Seller Help & Support

  • 1. Admin Support: Section 1 indicates where you can get support from the admin if there are any issues.
  • 2. Support Ticket Creation: Section 2 is the support ticket creation form.
  • 3. Ticket List: Section 3 displays the ticket list, allowing you to follow up on each ticket individually.
  • 4. Live Chat: Section 4 provides live chat with the admin for immediate assistance.

Our Support

You can have a customer support services from us 24/7. For any kind of queries, please feel free to contact us for customization, support and suggestion. Your satisfaction is our utmost priority! We are absolutely committed to our valued customers to provide the best services. We do appreciate your valuable feedback and your feedback helps us to improve our business and services.

Create Support Ticket: Help Center