Mobile App Troubleshooting

The CE Pro mobile app works alongside the web app. Your data syncs between both. This guide covers the most common mobile issues and how to fix them.

Finding Mobile Tools

Current V2 navigation is role-aware:

• The Road workspace uses Home, Leads, Create, Estimates, and

More. Eligible owners, admins, office teammates, and sales reps open More > Schedule or More > Inbox.

• The Crew workspace uses Today, Truck, My pay, and More.

Crew-only members do not receive the customer Inbox or Phone destinations; use More > Schedule to browse assigned work on another date, then open an assigned job for its dispatch context.

V1 uses the established six-tab baseline: Home, Schedule, Create, Inbox, Phone, and More. Those V1 destinations remain the feature and workflow parity baseline, but they should not be used to locate a control in the focused V2 shell. In V1, Schedule contains the calendar, truck and staff filters, and the selected day's route. There is no separate Map tab.

In either version, More shows only the records and workspace tools allowed for that role. Profile, notifications, offline storage, and About remain there; business destinations can be hidden or disabled when the matching permission or focused mobile contract is unavailable.

In current V2 Road, the center Create action opens the focused native create choices that are already supported safely. In the V1 baseline, permitted users can add a Client, Lead, Estimate, Job, Invoice, or Task / Event from that slot. V2 does not restore the old estimate-wizard navigation while parity work ports the supported creation workflows into the cleaner shell.

App Not Syncing

If changes you made on the web are not appearing in the mobile app, or vice versa:

1. Check your internet connection. The app needs Wi-Fi or cellular data to sync. Open a browser on your phone and load any website to confirm you are connected.

1. Pull down to refresh. On the main screen, pull down to force a manual sync.

1. Check for offline changes. If you made changes while offline, they sync

automatically when you reconnect. Open More > Offline & Storage to see queued work, retry failed items, or confirm that the queue is clear.

1. Close and reopen the app. If sync is stuck, force-close the app and reopen it. This resets the sync connection.

The app does not place sync errors in a global banner over working screens. Background sync continues automatically, and More > Offline & Storage is the single place for queue health, failed-item details, and manual retry controls.

Cannot Log In

If you cannot log in to the mobile app:

1. Use the same credentials as the web app. Your mobile login uses the same email and password as the web version. There is no separate mobile account.

1. Reset your password. Tap Forgot password? on the login screen. Enter your email address and follow the reset link.

1. Check your account status. If your account has been deactivated by an administrator, you cannot log in. Ask your admin to check your status in Settings --> Team on the web app.

Push Notifications Not Working

If you are not receiving push notifications:

Check phone settings

Go to your phone's Settings --> CE Pro --> Notifications and make sure notifications are enabled.

Check app settings

In the CE Pro app, go to More --> Notifications and verify all notification types are turned on.

Android battery optimization

On Android, battery optimization can block background notifications. Go to Settings --> Battery --> CE Pro and set it to "Unrestricted" or "Don't optimize."

Re-register for notifications

Force-close the app and reopen it. This re-registers your device for push notifications.

If the server cannot save the device token, the app now leaves the local token uncached so registration retries on the next setup attempt. Signing out follows the same safety rule in reverse: a failed server removal keeps the local token available for a later retry instead of falsely reporting that the device was fully unregistered.

Photos Not Uploading

If photos you take or attach are not uploading:

1. Check your internet connection. Photos require an active connection to upload.

1. Check app permissions. Go to your phone's Settings --> CE Pro --> Permissions and make sure Camera and Photo Library access are granted.

1. Wait for slow connections. Large photos take longer on slow cellular connections. Look for an upload progress indicator before navigating away.

1. Reduce photo quality. If uploads consistently fail, check the app settings for a photo quality option. Lower quality means smaller file sizes and faster uploads.

Offline Mode

CE Pro works offline for core features. Here is what you can do without an internet connection:

• View your schedule.
• Update job status.
• Take notes on jobs.
• View previously loaded client information.

How offline sync works

Changes made offline are stored locally on your device. When you reconnect to the internet, the app syncs your changes automatically.

Sync conflicts

If someone edited the same record on the web while you were offline, a sync conflict occurs. The most recent change wins. Check the record after syncing to make sure your changes were applied.

Check sync status

Go to More --> Offline & Storage in the app to see:

• Sync status — Whether the app is currently synced or has pending changes.
• Queue size — The number of changes waiting to upload.

App Crashing or Freezing

If the app crashes or becomes unresponsive:

1. Update to the latest version. Open the App Store (iOS) or Google Play (Android) and check for updates. Running an outdated version is the most common cause of crashes.

This is especially important if the app crashes while creating proposals or adding line items. Recent mobile builds include stability fixes for proposal creation flows.

1. Clear the app cache. Go to your phone's Settings --> CE Pro --> Storage --> Clear Cache. This removes temporary data without deleting your account.

1. Restart your phone. A full restart clears memory and can resolve intermittent issues.

1. Reinstall the app. If the issue persists, uninstall and reinstall CE Pro from your app store. Your data is stored on the server, not on your phone. Nothing is lost when you reinstall.

Home closes immediately after an update

Current builds keep Home open when dashboard activity is temporarily incomplete during a backend rollout. The app uses the authenticated account and selected workspace for the header, and missing activity sections recover as empty states on refresh.

The mobile connection also verifies that successful API responses are valid JSON. If a hosting or access-protection layer returns an HTML page with a 200 status, or a response contains broken JSON, the app treats it as a temporary connection failure and retries through its normal bounded recovery path. The unexpected response body is not shown or stored in mobile diagnostics.

If an older internal or preview build still closes as soon as Home appears:

1. Install the latest approved build or over-the-air update.
2. Fully close and reopen the app once so a downloaded Expo update becomes

active.

1. Confirm the correct account and workspace appear, then pull down on Home to

reload appointments, pipeline, and follow-ups.

1. If it still closes, record the build and update identifiers from **More >

About** and send a bug report. Do not clear app data when unsynced work is waiting on the device.

Getting Help

If none of these steps resolve your issue:

• Note your phone model and operating system version.
• Note the app version (found in More --> About in the app).
• Describe the issue and when it started.
• Contact support with these details.