🛠️ Quick Fix Guide

1. Check Connection (Top Wi-Fi Icon)

Look at the Wi-Fi icon at the top of the app to rule out network issues.

Green: Good to go.

Yellow/Red: Network lag. Check your wifi or switch to a hotspot.

Ping Check: If it’s over 300ms, the app will be sluggish.

2. Hit the "Reset" Button

On the Login Screen, tap the Reset App Data button.

What it does: Wipes local IndexedDB (data) and Cache (files).

Is it safe? Yes. It doesn't delete your account; it just forces a fresh sync from the server.

Use when: App is stuck on the splash screen or throwing "Unexpected Errors."

3. Reinstall (The Final Fix)

If the connection is Green and Reset didn't work, the PWA aka App installation is likely corrupted.

Delete: Long-press the app icon and Delete Bookmark.

Close Tabs: Close all browser tabs running the app.

Reinstall: Go to the app URL (fieldops.totalwarehouse.com) in your browser, tap on “Share” and then tap "Add to Home Screen."

Still Broken?

If you've done all three and it's still failing:

Take a screenshot of your Connection/Ping.

Send an email with the screen shot and with your device model to: IT@totalwarehouse.com , nitya@totalwarehouse.com and josh@totalwarehouse.com 

🛠️ Connection & App Troubleshooting Guide

If you are experiencing lag, login loops, or data that won't refresh, use the tools built directly into the login screen and interface to diagnose the issue.

1. The Connection Status Icon

Located in the top of your screen, the Wi-Fi Icon provides a real-time health check of your connection to our servers.

Ping (ms): This measures "latency." A lower number (under 100ms) means a responsive experience. If this is over 300ms, you may experience significant delays.

Connection Quality: * Green: Optimal connection.

Yellow: Stable but slow; you might see some loading spinners.

Red: Critically weak or disconnected. Check your local router or switch to a different network.

2. The "Hard Reset" Button

Sometimes, the data stored in your browser (IndexedDB) or temporary files (Cache) can become "stale" or corrupted, preventing a successful login.

On the Login Screen, you will find a Reset App Data button.

⚠️ What happens when I click Reset?

Clears IndexedDB: Wipes the local database stored on your device.

Purges Cache: Forces the app to download the latest version of all files and images.

Security: It does not delete your account or your data on our servers; it simply clears the local "copy" on your current device.

When to use it:

If the app hangs on the loading "splash" screen.

If you see persistent "Unexpected Error" messages during login.

3. Reinstall the App (PWA)

If your connection is Green and the Hard Reset didn't solve the issue, there may be a glitch with the app's installation on your device. Reinstalling the PWA ensures you have a clean slate and the most recent system updates.

How to reinstall:

Uninstall: Locate the app icon on your home screen, long-press the app, and select Delete Bookmark.

Clear Browser Tabs: Close any open tabs of the app in your browser (Safari).

Reinstall: Open your browser, navigate to URL (fieldops.totalwarehouse.com), tap on “Share” and then tap "Add to Home Screen."

Still having trouble?

If your connection is Green and you have performed a Hard Reset but still cannot log in, please email our support team with a screenshot of your connection stats: IT@totalwarehouse.com , nitya@totalwarehouse.com and josh@totalwarehouse.com