Troubleshooting
The installer says “Front-end assets are missing”
Section titled “The installer says “Front-end assets are missing””The backend/public/build folder wasn’t uploaded. Upload it from the download (it’s inside
backend/public/) and reload the page.
A blank page or “Server error” before or after installing
Section titled “A blank page or “Server error” before or after installing”Almost always folder permissions. Make these writable by the web server, then reload:
chmod -R 775 storage bootstrap/cachechown -R www-data:www-data storage bootstrap/cache # your web server's userThe error itself is in storage/logs/ (the newest file).
Emails or push notifications don’t arrive
Section titled “Emails or push notifications don’t arrive”The queue worker isn’t running. Check Admin → System health, and set up the worker (Server setup). Push notifications also need the Firebase service account (Firebase).
Scheduled orders don’t release / unpaid orders aren’t cancelled
Section titled “Scheduled orders don’t release / unpaid orders aren’t cancelled”The scheduler’s cron job isn’t running. Admin → System health shows when it last ran.
New orders appear only after a few seconds
Section titled “New orders appear only after a few seconds”Realtime isn’t set up — screens are refreshing on a timer instead. That’s fine; for instant updates, set up Reverb or Pusher (Server setup).
Store panel: “Signing in on the web isn’t set up yet”
Section titled “Store panel: “Signing in on the web isn’t set up yet””Add the Firebase web app in Admin → Settings → Integrations → Store panel sign-in (Firebase).
The app shows a connection error on a real phone
Section titled “The app shows a connection error on a real phone”Its baseUrl in lib/app_config.dart is empty or wrong. Set it to your server and build again
(Connect the apps).
Also check the site opens over https on the phone’s browser.
Phone sign-in fails on Android (“app not authorized” or a reCAPTCHA page)
Section titled “Phone sign-in fails on Android (“app not authorized” or a reCAPTCHA page)”Your signing key’s SHA-1/SHA-256 aren’t in Firebase. Add the debug, release and Play App signing fingerprints (Firebase for the apps).
Google sign-in crashes or does nothing on iOS
Section titled “Google sign-in crashes or does nothing on iOS”The Info.plist placeholders weren’t replaced with your CLIENT_ID and REVERSED_CLIENT_ID
(Firebase for the apps).
No notifications on iPhone
Section titled “No notifications on iPhone”Upload your APNs key to Firebase for that app, and test on a real phone — simulators don’t receive pushes (Push notifications).
The map is grey in the customer app
Section titled “The map is grey in the customer app”The Maps SDK key is missing or restricted to another app (Google Maps in the app).
Google Play rejects the upload: “signed in debug mode”
Section titled “Google Play rejects the upload: “signed in debug mode””Create android/key.properties with your upload key (Build for Android).
Google Play says “version code has already been used”
Section titled “Google Play says “version code has already been used””Increase the build number after + in pubspec.yaml (1.0.0+2) and build again.
pod install or the iOS build fails
Section titled “pod install or the iOS build fails”cd iospod repo updatepod installThen build again. If Xcode was updated, open the workspace once in Xcode first.