tracelet_web
📚 Official Documentation: tracelet.ikolvi.com
⚡ Set up Tracelet with AI. Clicking the badge opens Tracelet and copies a ready-made prompt — paste it into your AI coding assistant (Cursor, Claude Code, Kiro, Copilot Chat…) and it interviews you, then installs and configures Tracelet in your Flutter app.
Web implementation of the Tracelet background geolocation plugin.
This package uses browser APIs (Geolocation, Permissions, fetch, navigator.onLine) to provide foreground-only location tracking on the web.
Important: The web platform does not support background location tracking. The Web Geolocation API only works while the page/tab is in the foreground.
Usage
You should not depend on this package directly. Instead, depend on tracelet which automatically includes this package on web builds.
dependencies:
tracelet: ^1.1.0
For a full compatibility matrix of what works and what doesn't on web, see the Web Support Guide.
Features
| Feature | Status | Notes |
|---|---|---|
getCurrentPosition |
Full | Via navigator.geolocation.getCurrentPosition() with auto-fallback |
start / watchPosition |
Partial | Foreground only. No background tab tracking. |
stop / stopWatchPosition |
Full | Via navigator.geolocation.clearWatch() |
| Geofencing | Emulated | Distance-based enter/exit/dwell computed in Dart |
| Persistence | In-memory | Lost on page refresh. Use HTTP sync for durability. |
| HTTP Sync | Full | Via browser fetch() API with delta compression support |
| Permissions | Partial | Via navigator.permissions.query() |
| Connectivity | Full | Via navigator.onLine events |
| Mock Detection | Passthrough | Location.isMock always false — browser API has no spoof detection |
| OEM Compatibility | Stub | isAggressiveOem: false — no OEM power management on web |
| Headless / Background | No | Not possible on web |
| System Settings | No | Cannot open OS settings from browser |
Related Packages
| Package | Description |
|---|---|
tracelet |
App-facing Dart API — the only package you depend on |
tracelet_platform_interface |
Abstract platform interface |
tracelet_android |
Android implementation |
tracelet_ios |
iOS implementation |
More Information
Libraries
- tracelet_web
- Web implementation of the Tracelet background geolocation plugin.