Documentation

Mobile App Troubleshooting & FAQ

Common problems when configuring or running the SaleX mobile app, plus frequently asked questions.

On this page

Troubleshooting

Unable to connect to the server

Check that the base URL in lib/utils/app_constant.dart is correct, uses https://, and opens in a phone browser. Confirm your SaleX server is running and the SSL certificate is valid. See Domain, SSL & Email.

Login not working

Verify the email and password by logging in on the website first. Make sure the SaleX server is running and the app points to the right domain.

Images or files not loading

Check file permissions and storage configuration on the server, and confirm uploaded files open when you visit their address in a browser. See Database & Storage.

Push notifications not working

Confirm google-services.json and GoogleService-Info.plist are in the right folders, the package name and bundle identifier match Firebase, notification permission is allowed on the phone, and (for iOS) an APNs key is uploaded in Firebase. Test on a real device.

Build errors

Clean and rebuild:

flutter clean
flutter pub get
flutter run

Also check you are on a recent stable Flutter SDK (flutter --version, flutter upgrade) and run flutter doctor to find missing tools.

FAQ

Does the mobile app package include the backend?

No. The mobile app works together with your SaleX installation, which provides the data and the API. Install and deploy SaleX first.

Can I change the app name and logo?

Yes. See Mobile App Configuration for the name, package name, icons and theme.

Which platforms are supported?

Android and iOS, built from one Flutter code base.

Can I publish to Google Play and the App Store?

Yes. Build an App Bundle for Google Play (Build for Android) and an archive for the App Store (Build for iOS). You need your own developer accounts.

Is hosting included?

No. Hosting, domain, SSL certificate and third-party service fees are not included.

How do I get support?

Use the support channel described in FAQ & Support and include screenshots and the full error text.

Changelog