Skip to main content

How Data Synchronization Works (Mobile)

The Terros mobile app uses an offline-first architecture that keeps your data synced between your device and the server. This guide explains how synchronization works, especially for stats and interactions.

Hunter Allred avatar
Written by Hunter Allred
Updated over 2 months ago

How Sync Works

Automatic Background Sync The app automatically syncs data in the background without you needing to do anything:

  • When you open the app: Fresh data loads from the server

  • When you return to the app: Data refreshes if you've been away

  • When you reconnect to internet: Pending changes upload automatically

  • Every 20 minutes: Cached data is considered stale and refreshes

What Gets Synced

Interactions & Activity

  • Pitches, knocks, and customer contacts

  • Dispositions and outcomes

  • Notes and comments

  • Contact history

Stats & Performance

  • Daily and weekly metrics

  • Leaderboard rankings

  • Team performance data

  • Personal goals and progress

Accounts & Leads

  • Customer information

  • Account statuses and stages

  • Workflow progress

  • Appointments and events

Settings & Preferences

  • Map preferences (satellite vs standard)

  • Notification settings

  • Custom configurations

  • User profile updates

Cache Duration (How Long Data Stays Fresh)

Different types of data refresh at different intervals:

Frequently Refreshed (15-20 minutes)

  • Account statuses

  • Active stats and metrics

  • Email lists

  • Disposition lists

Moderately Refreshed (1-2 hours)

  • Competition leaderboards

  • Calendar events

  • Workflow data

  • Team assignments

Infrequently Refreshed (24 hours+)

  • Company settings

  • User roles and permissions

  • Intercom help articles

  • Company lists

Location Data (Special Handling)

  • Cached for up to 7 days

  • Automatically expires old data

  • Stores up to 150 geographic sectors

  • Refreshes when you visit an area

When Data Syncs

Automatic Triggers

  1. App Launch: All data refreshes when you open the app

  2. Return from Background: Data refreshes if stale (older than 20 minutes)

  3. Network Reconnection: Queued changes upload immediately

  4. Screen Focus: Some screens refresh when you navigate to them

Manual Refresh Pull-to-refresh works on most list screens:

  • Pull down on any list to force a refresh

  • Stats dashboard refreshes on pull-down

  • Leaderboard updates on pull-down

  • Team lists refresh on pull-down

Understanding Sync Status

Data Freshness Indicators

  • Recently synced: Data is current (less than 20 minutes old)

  • Stale data: Older than 20 minutes, will refresh on next opportunity

  • Cached only: No internet, showing offline data

  • Syncing: Upload or download in progress

When Stats Seem Wrong If your stats don't match what you expect:

  1. Pull to refresh: Force a data refresh on the stats screen

  2. Check internet: Ensure you have a connection

  3. Wait for sync: Recent activity may take a few minutes to process

  4. Check timestamp: Look when data was last updated

Did this answer your question?