The Aplauso app automatically handles situations where you lose internet connectivity, allowing you to view cached data even when you can't reach the server.

Offline Indicator

When your device loses internet, a red banner appears at the top of every screen:

"No internet connection"

The screen subtitle may also show "Offline data" to indicate you are viewing cached information.

What Works Offline

FeatureOffline Available?Notes
View earnings dashboard✅ YesShows cached data
View tip history✅ YesLast synced list
View ratings✅ YesLast synced list
Display your QR code✅ YesQR code is generated locally
View notifications✅ YesStored on device
Change app preferences✅ YesSaved locally
Accept Tap to Pay payment❌ NoRequires active internet
Register new tips via kiosk/QR❌ NoGuest device needs internet
Withdraw funds / open Stripe❌ NoRequires internet
Sync new tips/ratings❌ NoRequires internet

Cache Duration

Data TypeCache Lifetime
Employee profile10 minutes
Tips5 minutes
Ratings5 minutes
Analytics5 minutes

After the cache expires, data is shown as "stale" but remains visible rather than showing an error.

Refreshing When Back Online

When connectivity returns:

  1. The red banner disappears automatically.
  2. Pull down on the Home, Wallet, or any data screen to force a refresh and pull the latest data.
  3. Or wait up to 5 minutes for the next automatic cache refresh cycle.

Auto Refresh

If you are in an area with intermittent connectivity, enable Auto Refresh in Settings → Preferences to automatically pull fresh data when the connection is restored. Set the interval (default: 60 seconds) to control how often the app requests new data.

Tips Are Never Lost

If a guest tips via your QR code or the kiosk while you are offline, the tip still processes on the server because their device handles the transaction. You will see the tip in your dashboard as soon as you come back online and refresh.

Troubleshooting

ProblemFix
Red banner won't go awayCheck phone Settings → WiFi / Mobile Data. Try toggling airplane mode off.
Data hasn't updated after reconnectingPull down to refresh on the Home screen.
Stale data for more than 15 minutesForce-close the app and reopen it. Check for app updates.