Build location-aware apps without building location infrastructure.

// Three calls: getInstance -> ready -> start.
val tracker: Tracker by lazy { Tracker.getInstance(this) }

when (val result = tracker.ready(
    TrackerConfig.builder()
        .license(BuildConfig.FIELDTRACK_LICENSE)
        .build()
)) {
    is TrackerResult.Ok    -> Log.d("app", "ready: ${result.value}")
    is TrackerResult.Error -> Log.w("app", "${result.code}: ${result.message}")
}

// Once permissions are granted. Before ready(), this is NOT_READY.
when (val session = tracker.start(tag = "commute")) {
    is TrackerResult.Ok    -> Log.d("app", "session ${session.value.id}")
    is TrackerResult.Error -> Log.w("app", "${session.code}")
}

Kotlin · 17 lines · Full Android guide

import SwiftUI
import TrackerCore

@main
struct MyApp: App {
    init() {
        // ready() belongs here - registering after launch completes throws.
        Task { _ = await Tracker.shared.ready() }
    }

    var body: some Scene { WindowGroup { ContentView() } }
}

// The ladder is ordered: Always can only be asked for from When-In-Use.
let tier = await Tracker.shared.permissions().requestWhenInUse()
guard tier != .none else { return }

switch await Tracker.shared.start(tag: "delivery-run") {
case .success(let session): print("recording \(session.id)")
case .failure(let code, let message): print("refused - \(code.rawValue): \(message)")
@unknown default: break
}

Swift · 22 lines · Full iOS guide

import Tracker, { onTrackerEvent } from '@fieldtrack360/react-native-tracker';

const result = await Tracker.ready({
  trackingMode: 'adaptive',
  intervalMs: 1000,
});
if (!result.ok) console.warn('ready failed', result.code, result.message);

const started = await Tracker.start('morning-route');
if (!started.ok) console.warn(started.code, started.message);

const unsubscribe = onTrackerEvent((event) => {
  if (event.type === 'location') {
    console.log(event.point.latitude, event.point.longitude);
  }
});

TypeScript · 16 lines · Full React Native guide

import 'package:trackit_flutter/trackit_flutter.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  // Subscribe FIRST - the stream has no replay.
  Tracker.instance.events.listen(_handleEvent);

  // Start readiness, but do NOT await it before the first frame.
  final ready = Tracker.instance
      .ready(const TrackerConfig())
      .timeout(const Duration(seconds: 15));

  runApp(MyApp(ready: ready));
}

// Once permissions are granted:
final session = await Tracker.instance.start(tag: 'commute');

Dart · 18 lines · Full Flutter guide