Instacart's Offline First: Introducing TrueTime for Swift and Android
Original post Offline First: Introducing TrueTime for Swift and Android
Article Summary
Instacart shoppers were losing minutes in grocery store dead zones. The culprit? You can't trust device clocks when every second counts.
Instacart open sourced TrueTime, an NTP library for Swift and Android that solves a deceptively tricky problem: getting accurate time on mobile devices. This is part one of their offline-first architecture series.
Key Takeaways
- Device clocks drift by minutes despite NTP, users manually adjust time zones
- TrueTime queries NTP servers once at app start, then uses device uptime offset
- Android version includes RxJava extension with parallel requests and automatic retries
- iOS version auto-handles reachability events and supports iOS, macOS, and tvOS
When you're promising one-hour delivery, you need millisecond precision that survives spotty networks and user clock tampering.
Continue reading
Software Mansion
Aug 26, 2026
More from Instacart
Migrating to Jetpack Compose: How AI Accelerated Our Journey at Caper
Instacart
Feb 3, 2026
Also on iOS
General Availability of Mobile Platform Support Arrives in Discord Social SDK Version 1.10
Discord
Aug 6, 2026
What This Article Covers
Instacart's shopper app had trouble reliably timestamping critical order events. iOS and Android don't provide a way to get time that isn't affected by user timezone changes or clock drift, which can span several minutes.
Kaushik Gopal's team built TrueTime to solve this. It queries NTP servers once when the app starts, calculates the delta between device uptime and server response, then applies that offset to all subsequent time requests.
The open-source library lets Instacart guarantee millisecond-precision timestamps for one-hour delivery orders on both Android and iOS. The RxJava extension supports parallel UDP requests with automatic retry logic.
This page summarizes “Offline First: Introducing TrueTime for Swift and Android” by Instacart, published Sep 12, 2016. All credit for the original work goes to the authors.
