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.
Requirements
Backend
- A working SaleX installation, deployed on a server and reachable from the internet
- A valid domain name with an HTTPS (SSL) certificate
- The SaleX API routes available on that domain
Development tools
- Flutter SDK (latest stable version recommended) and the Dart SDK that comes with it
- Android Studio or Visual Studio Code
- Android SDK (installed with Android Studio)
- Xcode on a Mac, which is required for iOS builds
Publishing accounts
- Google Play Developer account, for the Android release
- Apple Developer account, for the iOS release
- A free Firebase account, for push notifications
Setup order
Follow the pages in this order. Each one ends with a link to the next.
-
Connect the app to your server
Set the base URL and customize theme, name, package name and icons in Mobile App Configuration.
-
Set up Firebase
Add the Firebase configuration files so push notifications work: Firebase Configuration.
-
Build for Android
Produce an APK for testing and an App Bundle for Google Play: Build for Android.
-
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.