Network and Connectivity Issues
Benchmrk is a web application that requires an active internet connection for most features. When your network is unstable or unavailable, here's what to expect and how to troubleshoot.
Offline Behaviour
Benchmrk does not have a full offline mode. When your network connection is lost:
- Map tiles that are already loaded remain visible, but new tiles won't load as you pan or zoom
- Search will fail — all searches require a server round-trip
- Ledger operations (save, delete, snapshot) will fail
- AI Assist analysis cannot be initiated
- Point details for marks not already loaded will be unavailable
- The DocsPanel may continue to display its current page but won't navigate to new pages
When connectivity returns: Refresh the page to restore full functionality. In-progress operations that failed during the outage will need to be retried manually.
API Timeouts
API requests can time out due to slow network conditions, server load, or large response payloads.
| Feature | Typical Timeout | What Happens |
|---|---|---|
| Search requests | 10–15 seconds | Error message displayed in the search results area |
| Point details | 10 seconds | Loading spinner, then error state in the details panel |
| AI analysis | 30–60 seconds | Timeout message with option to retry |
| Report generation | 30 seconds | Export fails with a timeout error |
| Map tile loading | Per-tile timeout | Grey/missing tiles on the map |
Resolving Timeouts
- Check your connection speed — Run a speed test. Benchmrk works best on connections with at least 5 Mbps download speed.
- Retry the operation — Transient timeouts often resolve on a second attempt.
- Reduce the request scope — For searches or exports, try a more specific query or smaller dataset.
- Try a different network — If you're on a corporate VPN or restricted network, try a direct connection.
Retry Mechanisms
Benchmrk handles transient network failures with limited automatic retries:
- Map tiles: The map library automatically retries failed tile requests
- API requests: Most API calls do not auto-retry. If a request fails, you'll need to retry the action manually
- Authentication: Authentication tokens refresh automatically in the background
Network Requirements
For the best experience, ensure your network allows access to:
| Domain | Purpose |
|---|---|
| Main application domain | Main application |
| Documentation site domain | Documentation site (DocsPanel) |
| Map tile provider domains | Map tiles and geocoding |
| Authentication provider domains | Authentication |
| Payment provider domain | Subscription billing |
If you're on a corporate network, ask your IT team to whitelist the domains listed above. Firewalls and proxy servers can interfere with map tile loading and API requests.