Documentation

Mobile App Overview

The SaleX mobile app is a Flutter application for Android and iOS that connects to your SaleX marketplace. This section walks you through connecting it to your server, branding it, and publishing it to the stores.

On this page

Introduction

The mobile app gives your customers (and, where enabled, vendors) a native way to use your marketplace. It is built with Flutter, so a single code base produces both the Android and the iOS app.

The app does not hold any data of its own. Everything it shows, such as products, carts, orders and accounts, comes from your SaleX server, and push notifications are delivered through Firebase.

Not a standalone app The mobile app only works when it can reach a running SaleX installation. Hosting, domain name, SSL certificate and server configuration are not part of the mobile app package. Complete Server Deployment and Domain, SSL & Email first.

Requirements

Backend

Development tools

Publishing accounts

Costs Store accounts and any third-party service fees are paid by you and are not included with your SaleX purchase.

Setup order

Follow the pages in this order. Each one ends with a link to the next.

  1. Connect the app to your server

    Set the base URL and customize theme, name, package name and icons in Mobile App Configuration.

  2. Set up Firebase

    Add the Firebase configuration files so push notifications work: Firebase Configuration.

  3. Build for Android

    Produce an APK for testing and an App Bundle for Google Play: Build for Android.

  4. Build for iOS

    Configure signing in Xcode and prepare the App Store build: Build for iOS.

If something goes wrong, see Mobile App Troubleshooting & FAQ.