TrailBites: Geolocation Site & Time Tracking

App Overview

TrailBites is a high-precision, localized B2B mobile solution engineered for professionals who require undisputed field-to-site mileage tracking and automated geofence time-auditing. Built on a foundation of absolute data sovereignty and battery efficiency, TrailBites completely eliminates the security risks of third-party cloud data hoarding by keeping 100% of your operational history securely stored on your local device.

Absolute Data Sovereignty & Security

We don't want your data, we don't collect your data, and we don't run a cloud database to leak your sensitive client locations or route history. Our ultra-lean C# Native AOT backend handles only a secure, cryptographic licensing handshake to verify subscriptions—your actual location intelligence remains entirely under your physical control. You own the vault, and you decide exactly when and how to export your logs, location history, or timelines via convenient, built-in standard Android file sharing controls.

User-Controlled Privacy Engine

Professional utility should never mean invasive surveillance. TrailBites features a hard hardware-level toggle to completely kill the tracking engine instantly, alongside an automated scheduling matrix. Define your active workdays and precise start/end hours; the moment off-hours hit, background tracking drops to absolute zero. Your personal time stays private, and your battery life stays protected.

Exclusive 99-Seat Closed Alpha

To maintain absolute focus on product-market excellence and protect operational infrastructure overhead, alpha testing seats are strictly capped. Access requires an upfront 1-year subscription commitment.

Why the Commitment?

• No Tire-Kickers: We have limited capacity and are strictly filtering for high-intent professionals invested in the tool's success.
• Direct Influence: Work directly with the engineering team to shape a lean, cloud-free tracking alternative.
• Instant ROI: Built purely for B2B efficiency. By locking down undisputed mileage logs and automated time-auditing, this utility pays for itself by streamlining timesheets, milage expense reporting, invoicing, and more.

Application Screenshots

Main Settings Tab

Main Application Screen

History Options Dialog

History View Screen

Time Line Screen

Time Travel Feature

Zone Management Options

Zone Editor Dialog

App Settings Tab

Profile Selection Screen

Tuning Profile Editor

Core Architecture

At the heart of TrailBites is an **Extended Kalman Filter (EKF)** that continuously smooths incoming raw GNSS data, throwing out urban canyon multipath errors and signal drift before it hits storage.

Local Persistence & Background Resilience

The system utilizes a Sticky Foreground Service running natively on Android to guarantee location capture and persistence even without the app running. Location metrics are secured inside a local, fully encrypted SQLite/ROOM database utilizing the following strict event schema:

data class GPSQueueEventEntry(
    val id: Long,
    val timestamp: String,
    val latitude: Double,
    val longitude: Double,
    val accuracy: Float,
    val velocity: Float,
    val bearing: Float,
    val uncertainty: Float,
    val activity: String,
    val isPowered: Boolean,
    val interval: Long,
    val satsUsed: Int,
    val avgCn: Float
)

Feature Manifest

Interactive Map & Navigation

• Follow Me: Real-time map viewport auto-centering driven dynamically by the latest filtered pipeline event.
• Add Note (FAB): Easily save a timestamped note. Utilizes Android's IME - supporting Speech-to-Text note taking. Notes automatically appear in their corresponding Time Line entry.
• 🔒 Secure Lock-Screen Bypass (Opt-In): Enable maximum field efficiency. Utilizes Android OS's Quick Settings to launch the Add Note dialog without unlocking your device. IME allows you to dictate tool runs or receipt totals via built-in speech to text functionality.

[History] Subsystem

• Temporal Filtering: Isolate location tracking data points via granular Start/End date-time parameters.
• Raw Ledger: Comprehensive, chronological display of raw GPSQueueEntryEvents sorted from newest to oldest.
• Dynamic Timeline: Generates real-time, daily chronological intervals dividing activities into localized tracking statuses:
  • In-Zone: Captures designated Zone Name, precise Entry/Exit times, and complete duration.
  • Out-of-Zone (OOZ): Tallies travel windows, total transit duration, and accumulated mileage/kilometers.
  • Notes: Real-Time notes are automatically associated with & displayed in the appropriate timeline entries.
• Time Travel: Renders route data directly onto the Map using an RDP algorithm and features a playback scroll control.
• Access: Review your entire week seamlessly within the app. Because your notes, material runs, and precise mileage intervals are already compiled chronologically, you can fill out timesheets, mileage expense reports, and invoice line items directly from the Time Line screen—no data exports required.
• Sharing: Robust interface supporting instant, text-formatted or CSV data export via native Android Share targets for easy importing.

[Zones] Geofencing

• Dynamic Bounds Creation: Deploy custom operational boundaries instantly centered on current coordinate profiles using either circular (Variable Radius) or rectangular (Width/Height) bounding volumes.
• Retroactive Evaluation: Because the underlying location ledger remains static while timelines and RDP profiles are generate dynamically, you can freely add, resize, delete, or translate zones retroactively without destroying historical telemetry records.
• Canvas Interaction: Long-press a zone element to toggle a collapsed vector edit mode, exposing a structural drag-and-drop anchor for easy zone repositioning.

[Settings & Engine Tuning]

• App Preferences: Total toggle state authority over Geolocation state, Diagnostic UI Cards, 12/24hr formatting, Imperial metrics, and a full operational tracking schedule configuration interface.
• Adaptive Engine Profiles: Deep hardware orchestration control allowing developers and users to build customized power profiles modifying: Truth Fix Intervals Reporting Intervals Accuracy Dominance Reality Snap Distance Velocity Deadband Uncertainty Bloom
• Activity Aware: Dynamically switches tracking profiles on the fly by combining native device state detection with charging conditions (Plugged In, Battery, Still, Walking, Running, Cycling, In-Vehicle) to aggressively minimize CPU and battery drain.

System Service Notifications

To comply with native hardware tracking constraints, the system exposes two persistent, highly transparent notification views:

• [Main View]: Engine State (Active/Sleeping), Current Power, Detected Activity, Active Tuning Profile, Subscription Validation, and Last Fix Coordinates.
• [Diagnostics View]: Real-time hardware performance matrices including explicit satellite counts, average carrier-to-noise density (C/N0), active constellations, raw sensory telemetry, and real-time EKF structural state output updated via an isolated 1-second interval execution thread.