native_location_tracker library

Native-first background location tracking for Flutter.

This package provides robust background location tracking with:

Cross-platform support (Android + iOS)
Native-first persistence (SQLite on both platforms)
Automatic batch uploads via native HTTP
Adaptive sampling based on speed and motion state
Configurable tracking modes (lowPower vs fast)

Architecture

Native is the single source of truth for persistence and upload. Dart observes native state and provides UI-facing streams only.

Quick Start

import 'package:native_location_tracker/native_location_tracker.dart';

// Initialize with your upload endpoint
await BackgroundLocation.initialize(
  config: UploadConfig(
    uploadUrl: 'https://api.example.com/location/update',
    accessToken: myToken,
  ),
);

// Start tracking
await BackgroundLocation.instance.startTracking(
  TrackingOptions(sessionId: 'trip-123', mode: TrackingMode.fast),
);

// Listen for updates
BackgroundLocation.instance.locationStream.listen((point) {
  print('Location: ${point.lat}, ${point.lng}');
});

// Stop when done
await BackgroundLocation.instance.stopTracking();