dhruva
0.1.1indexedOne-shot and continuous location tracking with configurable timeouts and intervals, lifecycle-aware updates, typed error returns, battery-optimized defaults, and UI-friendly factory.
0
Stars
—
Used by
dependents
—
Health
/ 100
🌟 Dhruva
ध्रुव, the polestar. The unmoving guide that helps you find where you are.
A small Kotlin Multiplatform location library for Android and iOS. One-shot and continuous tracking, with the right defaults baked in.
Why Dhruva
Location code looks the same in every Android codebase: import FusedLocationProviderClient,
write a LocationCallback, deal with foreground / background lifecycle, marshal to a
Flow. On iOS it's CLLocationManager, a CLLocationManagerDelegate, lifecycle
hooks. None of it is hard, but all of it is paperwork.
Dhruva is the paperwork:
- A single
LocationTrackerinterface with and .
Highlights
- One-shot location with configurable timeout. Fast, seeds from the last known location while waiting.
- Continuous tracking as a . Updates respect interval and distance config. Cancel the flow to stop tracking.
Quickstart
@Composable
fun WhereAmI() {
val tracker = rememberLocationTracker()
var label by remember { mutableStateOf("Tap to find me") }
val scope = rememberCoroutineScope()
Button(onClick = {
scope.launch {
label = runCatching { tracker.getCurrentLocation() }
.map { "${it.latitude}, ${it.longitude}" }
.getOrElse { e -> "Couldn't locate: " }
}
}) {
Text(label)
}
}
Continuous tracking:
LaunchedEffect(Unit) {
tracker.startTracking(LocationConfig(updateIntervalMs = 5_000))
.collect { location ->
map.center(location)
}
}
Modules
Supported platforms
- Android API 28+ (Android 7.0). Android target uses
FusedLocationProviderClient, so the host app must include Google Play Services. - iOS 15.3+. Uses
CLLocationManagerdirectly, no extra dependencies.
Roadmap
- Geocoding (forward / reverse) as a separate
dhruva-geocodingmodule. - Background location, with explicit opt-in.
- Geofencing.
- A non-Google-Play Android backend using
LocationManagerdirectly, for FOSS distribution.
Pairs well with
- Aagya for the permission flow. The two libraries are intentionally decoupled but share design philosophy.
Contributing
See CONTRIBUTING.md. PRs welcome.
License
Dhruva is named for ध्रुव, the polestar in Indian astronomy, traditionally the fixed point that mariners used to find their way home.