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 runAlso 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
- Version 1.0.0 – Initial release of the SaleX mobile app documentation.