Offline mode

Documentation Index

Fetch the complete documentation index at: https://withforerunner.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

The Forerunner mobile app is built for field work where internet connectivity is unreliable or unavailable. Offline mode lets you download map data before heading out, then create properties, submit records, and complete tasks without a connection. Your work automatically syncs when you’re back online.

​

How offline mode works

Offline mode uses a download-first approach:

1. Download offline packs - While connected, download map packs containing properties, parcels, and map layers for your work area
2. Work offline - In the field, create and edit data without connectivity. Everything saves locally to your device.
3. Automatic sync - When you reconnect, the app automatically uploads your changes to Forerunner

The app continuously monitors your connection status and displays an indicator when you’re offline. You can work normally—the only difference is that data syncs later instead of immediately.

​

Download offline map packs

Offline packs contain everything you need to work in a specific area:

​

What’s included in offline packs

Each offline pack contains:

​

Enabling custom basemap imagery for offline mode

By default, offline packs include Forerunner’s standard satellite and streets base maps. If your account has custom aerial imagery or other custom base maps configured, a manager can turn them on for offline use so field teams see the same imagery offline as they do online. Offline imagery has to be configured at the account level before custom aerial layers can show up in the field. Only manager-level users can enable it from base map settings. Once it’s turned on for a base map, the imagery is included in every offline pack downloaded after that point.

​

Turning on offline use for a base map

​

Keeping imagery current

Offline base map tilesets refresh automatically once per quarter (on the first of January, April, July, and October). Each refresh re-pulls the latest tiles from the source and replaces the previous offline copy — the next offline pack a user downloads picks up the new tiles. If you need an update sooner, trigger a manual refresh from the actions menu on the base map’s row in Settings → Data → Base Maps. You can monitor refresh and enable jobs in the Recent imports section at the bottom of the Base Maps settings page, which shows status (Processing, Success, or Error), timestamps, and any error message. A manual refresh often resolves transient errors; for repeated failures, reach out to your Customer Success Manager.

​

Manage offline packs

​

View pack status

In Settings > Offline Maps, each pack shows:

• Ready - Downloaded and available for offline use
• Processing - Server is preparing the pack
• Expired - Pack is older than 15 days and needs refresh
• Download available - Pack hasn’t been downloaded yet

​

Update a pack

Offline packs expire after 15 days to ensure you have current data. To update:

​

Switch active packs

If you have multiple packs downloaded, only one can be active at a time:

​

Delete a pack

To free up device storage:

​

Create data offline

When offline, you can create:

​

Properties

Create new properties from your current GPS location or by entering coordinates:

1. Tap on the map where you want to create a property
2. Select Create property
3. Fill in the property details
4. Tap Save

The property saves locally with a “Pending sync” indicator. When you reconnect, it uploads to Forerunner and receives a permanent ID.

​

Records

Submit records using any record type included in your offline pack:

1. Open a property’s detail panel
2. Tap Records and select Add record
3. Choose the record type
4. Fill out the form fields
5. Attach photos or documents
6. Tap Submit

The record saves locally and syncs when you’re back online.

​

Tasks

Create and update tasks while offline:

1. Navigate to a property or custom object
2. Tap Tasks and select Add task
3. Fill in task details
4. Tap Save

Task status changes (To do → In progress → Complete) also save offline and sync later.

​

Capture photos offline

Photos captured while offline are stored on your device until sync:

​

Sync your work

​

Automatic sync

The app automatically syncs when you reconnect to the internet:

• The app detects connectivity and begins uploading pending data
• A sync indicator shows upload progress
• You receive confirmation when sync completes

Automatic sync starts after you’ve been online for a few minutes, allowing the connection to stabilize.

​

Manual sync

To trigger sync immediately:

1. Pull down on any list (task list, property records) to refresh
2. The app attempts to sync pending data and download any updates

​

Sync status indicators

The app shows sync status for your offline work:

​

Handle sync conflicts

The mobile app uses a last-write-wins approach for sync:

• Your offline changes overwrite any changes made to the same data on the web while you were offline
• If you and another user both edit the same property offline, the last person to sync “wins”
• The app doesn’t merge changes—it replaces server data with your offline version

​

Offline limitations

Some features require an internet connection:

​

Monitor connectivity

The app displays your connection status:

• Green indicator - Connected to the internet
• Yellow indicator - Slow or unstable connection
• Red indicator / “Offline” - No internet connection

When the connection is slow, the app may behave as if offline to avoid partial uploads or timeouts.

​

Offline best practices

Download packs on Wi-Fi - Downloading on Wi-Fi avoids cellular data charges and is faster. Update packs before they expire - Packs expire after 15 days. Set a reminder to refresh your packs weekly if you work in the field regularly. Check pack coverage before leaving - Verify your offline pack covers your entire work area. Areas outside the pack boundary won’t have offline data. Sync before starting new work - When you arrive at a site with connectivity, let the app sync first. This uploads pending data and downloads any recent changes from the web. Monitor storage - Offline packs and pending uploads consume device storage. Keep at least 500 MB free for smooth operation. Charge your device - GPS and offline operations can drain battery faster. Bring a charger or battery pack for full-day field work. Test offline before relying on it - Before critical field work, test offline mode while still near connectivity. Create a test record offline, then verify it syncs correctly.

​

Storage management

Offline data uses device storage:

​

Check storage usage

Go to your device’s Settings > Storage to see how much space Forerunner uses.

​

Clear offline data

If storage is low:

1. Delete unnecessary offline packs in Settings > Offline Maps
2. Ensure all pending data has synced before clearing
3. Re-download only the packs you currently need

​

Failed uploads

If a sync fails repeatedly, the app stores failed data as a backup file. This prevents data loss but consumes storage. Contact support if you see persistent sync failures.

​

Troubleshooting offline mode

​

Related documentation

• Getting started with mobile - Initial app setup and configuration
• Collecting field data - Creating records and capturing photos
• Using tasks on mobile - Task management in the field
• Troubleshooting - Resolve common mobile app issues