Skip to content

Colota - Android GPS Location tracker

docs: fix inaccuracies across documentation pages

Max Dietricha8a6359607e8
diff --git a/apps/docs/docs/configuration/authentication.md b/apps/docs/docs/configuration/authentication.md
index 1eb5abc6..c9c1a0ff 100644
--- a/apps/docs/docs/configuration/authentication.md
+++ b/apps/docs/docs/configuration/authentication.md
@@ -21,7 +21,7 @@ Colota supports multiple authentication methods, configurable in **Settings > Au
## Credential Storage
-All credentials are stored encrypted on-device using **AES-256-GCM** via Android's `EncryptedSharedPreferences`. Credentials never leave the device except as HTTP headers sent to your configured endpoint.
+All credentials are stored encrypted on-device using Android's `EncryptedSharedPreferences`. Credentials never leave the device except as HTTP headers sent to your configured endpoint.
## Custom HTTP Headers
diff --git a/apps/docs/docs/configuration/gps-settings.md b/apps/docs/docs/configuration/gps-settings.md
index d893130e..fb4e7d45 100644
--- a/apps/docs/docs/configuration/gps-settings.md
+++ b/apps/docs/docs/configuration/gps-settings.md
@@ -32,4 +32,4 @@ Only records a new location if you've moved at least this many meters since the
When enabled, GPS fixes with accuracy worse than the threshold are discarded. This prevents recording poor-quality positions from indoor or urban environments.
-Colota uses Android's `HIGH_ACCURACY` positioning mode, which combines GPS, Wi-Fi, and cellular data.
+The Google Play variant uses Android's `HIGH_ACCURACY` positioning mode via FusedLocationProvider, which combines GPS, Wi-Fi, and cellular data. The FOSS variant uses Android's native `LocationManager` with `GPS_PROVIDER` directly.
diff --git a/apps/docs/docs/development/architecture.md b/apps/docs/docs/development/architecture.md
index b2254f7a..87047f00 100644
--- a/apps/docs/docs/development/architecture.md
+++ b/apps/docs/docs/development/architecture.md
@@ -150,20 +150,20 @@ Centralized constants for condition type strings (`charging`, `android_auto`, `s
### SecureStorageHelper
-Wraps Android's `EncryptedSharedPreferences` for AES-256-GCM encrypted credential storage (Basic Auth passwords, Bearer tokens, custom headers).
+Wraps Android's `EncryptedSharedPreferences` for encrypted credential storage (AES-256-GCM for values, AES-256-SIV for keys). Stores Basic Auth passwords, Bearer tokens, and custom headers.
### Other Modules
-| Module | Purpose |
-| ---------------------- | ------------------------------------------------------------------------------------------ |
-| `LocationBootReceiver` | Auto-restarts tracking after device reboot |
-| `DeviceInfoHelper` | Device metadata and battery status with caching |
-| `FileOperations` | File I/O, sharing via FileProvider, and clipboard access |
-| `PayloadBuilder` | Builds JSON payloads with dynamic field mapping |
-| `ServiceConfig` | Centralized configuration data class |
-| `TimedCache` | Generic TTL cache used for queue count and device info |
-| `BuildConfigModule` | Exposes build constants (SDK versions, app version) to JS |
-| `AppLogger` | Centralized logger - logs when debug mode is enabled or in debug builds, errors always log |
+| Module | Purpose |
+| ---------------------- | ------------------------------------------------------------------------------------------- |
+| `LocationBootReceiver` | Auto-restarts tracking after device reboot |
+| `DeviceInfoHelper` | Device metadata and battery status with caching |
+| `FileOperations` | File I/O, sharing via FileProvider, and clipboard access |
+| `PayloadBuilder` | Builds JSON payloads with dynamic field mapping |
+| `ServiceConfig` | Centralized configuration data class |
+| `TimedCache` | Generic TTL cache used for queue count, device info, geofences, profiles, and network state |
+| `BuildConfigModule` | Exposes build constants (SDK versions, app version) to JS |
+| `AppLogger` | Centralized logger - logs when debug mode is enabled or in debug builds, errors always log |
## React Native Layer
@@ -178,7 +178,7 @@ Wraps Android's `EncryptedSharedPreferences` for AES-256-GCM encrypted credentia
| `GeofenceScreen` | Create, edit, and delete pause zones on an interactive map |
| `TrackingProfilesScreen` | List and manage condition-based tracking profiles |
| `ProfileEditorScreen` | Create/edit a profile's name, condition, GPS settings, priority, and deactivation delay |
-| `LocationHistoryScreen` | Calendar day picker with activity dots, map tab with trip-colored tracks, trips tab with trip cards and export |
+| `LocationInspectorScreen` | Calendar day picker with activity dots, map tab with trip-colored tracks, trips tab with trip cards and export |
| `TripDetailScreen` | Full trip view with dedicated map, stats grid, speed and elevation profile charts, and per-trip export |
| `LocationSummaryScreen` | Aggregated stats for selectable periods (week/month/30 days) with daily breakdown and tap-to-inspect navigation |
| `ExportDataScreen` | Export all tracked locations as CSV, GeoJSON, GPX, or KML |
@@ -194,6 +194,7 @@ Wraps Android's `EncryptedSharedPreferences` for AES-256-GCM encrypted credentia
| `LocationServicePermission` | Sequential Android permission requests (fine location → background location → notifications → battery exemption) |
| `ProfileService` | Thin wrapper over `NativeLocationService` for tracking profile CRUD and trip event queries |
| `SettingsService` | Bridges UI state to native SQLite with type conversion (seconds↔ms, objects↔JSON) |
+| `modalService` | Centralized alert and confirm dialogs via `showAlert()` and `showConfirm()` |
### Map Components
diff --git a/apps/docs/docs/development/local-setup.md b/apps/docs/docs/development/local-setup.md
index 6028c502..29baefdd 100644
--- a/apps/docs/docs/development/local-setup.md
+++ b/apps/docs/docs/development/local-setup.md
@@ -138,7 +138,7 @@ colota/
│ ├── colors.ts # Theme color definitions
│ ├── typography.ts # Font family and sizes
│ └── index.ts # Barrel exports
-├── scripts/ # Version bump and screenshot sync
+├── scripts/ # Screenshot sync
└── screenshots/
└── mobile/original/ # Screenshot source of truth
```
@@ -204,16 +204,6 @@ npx -w @colota/mobile tsc --noEmit # TypeScript type check
2. Run `npm run build` in `packages/shared/`
3. Both the mobile app and docs site will pick up the changes
-### Bumping the Version
-
-Use the version bump script to update all packages and the Android build in one command:
-
-```bash
-npm run version:bump 1.2.0
-```
-
-This updates `version` in all `package.json` files, `versionName` in `build.gradle`, and auto-increments `versionCode`.
-
### Syncing Screenshots
App screenshots live in `screenshots/mobile/original/` (single source of truth). After adding or updating screenshots there, sync them to the docs site and Fastlane store metadata:
diff --git a/apps/docs/docs/faq.md b/apps/docs/docs/faq.md
index 588a431d..1d2f3c7c 100644
--- a/apps/docs/docs/faq.md
+++ b/apps/docs/docs/faq.md
@@ -32,7 +32,7 @@ To ensure modifications stay open source, especially server-side components.
### Can I export my location history?
-Yes. Go to **Data Management > Export Data** to export in CSV, GeoJSON, GPX, or KML. See [Data Export](/docs/guides/data-export) for details.
+Yes. Tap **Export** on the Dashboard to export in CSV, GeoJSON, GPX, or KML. See [Data Export](/docs/guides/data-export) for details.
### What happens when the phone restarts?
diff --git a/apps/docs/docs/getting-started/build-from-source.md b/apps/docs/docs/getting-started/build-from-source.md
index f2a1fa27..d583caf2 100644
--- a/apps/docs/docs/getting-started/build-from-source.md
+++ b/apps/docs/docs/getting-started/build-from-source.md
@@ -25,7 +25,7 @@ cd apps/mobile/android
./gradlew assembleGmsRelease
```
-Output: `app/build/outputs/apk/gms/release/app-gms-release.apk`
+Output: `app/build/outputs/apk/gms/release/app-gms-arm64-v8a-release.apk` (per-ABI)
### FOSS variant (no Google Play Services)
@@ -33,7 +33,7 @@ Output: `app/build/outputs/apk/gms/release/app-gms-release.apk`
./gradlew assembleFossRelease
```
-Output: `app/build/outputs/apk/foss/release/app-foss-release.apk`
+Output: `app/build/outputs/apk/foss/release/app-foss-arm64-v8a-release.apk` (per-ABI)
### Build both
@@ -53,4 +53,4 @@ npm start # Start Metro bundler
npm run android # Build and install on connected device
```
-Use `npm run android:debug:foss` to build and run the FOSS variant instead.
+Use `npm run android:foss` to build and run the FOSS variant instead.
diff --git a/apps/docs/docs/integrations/api-templates.md b/apps/docs/docs/integrations/api-templates.md
index bcef319c..a5d24d3d 100644
--- a/apps/docs/docs/integrations/api-templates.md
+++ b/apps/docs/docs/integrations/api-templates.md
@@ -10,7 +10,7 @@ Colota includes built-in templates for popular backends. Select a template in **
| -------------- | ----------- | ------------- | -------------------------------- | --------------------------------- |
| **Dawarich** | POST | `cog` | `_type: "location"` | OwnTracks-compatible format |
| **OwnTracks** | POST | `cog` | `_type: "location"`, `tid: "AA"` | Standard OwnTracks HTTP format |
-| **PhoneTrack** | POST | `bearing` | `_type: "location"` | Nextcloud PhoneTrack format |
+| **PhoneTrack** | POST | `bearing` | `useragent: "Colota"` | Nextcloud PhoneTrack format |
| **Reitti** | POST | `bear` | `_type: "location"` | Standard field names |
| **Traccar** | GET | `bearing` | `id: "colota"` | OsmAnd protocol with query params |
| **Custom** | POST | `bear` | _(none)_ | Fully user-defined |
diff --git a/apps/docs/docs/integrations/custom-backend.md b/apps/docs/docs/integrations/custom-backend.md
index 99783e64..121e66e1 100644
--- a/apps/docs/docs/integrations/custom-backend.md
+++ b/apps/docs/docs/integrations/custom-backend.md
@@ -12,7 +12,7 @@ Your server needs to:
- Accept `POST` requests with JSON body, or `GET` requests with query parameters
- Return a 2xx status code on success
-- Handle `alt` and `bear` fields being absent (they are conditional)
+- Handle `alt`, `vel`, and `bear` fields being absent (they are conditional)
- Handle up to 10 concurrent requests during batch sync
HTTPS is required for public endpoints. HTTP is allowed for local addresses (`127.0.0.1`, `192.168.x.x`, `10.x.x.x`, `172.16-31.x.x`). On Android 17+, connecting to local network addresses (not localhost) requires the Nearby Wi-Fi Devices permission, which Colota requests when you use **Test Connection**.
diff --git a/apps/docs/docs/integrations/phonetrack.md b/apps/docs/docs/integrations/phonetrack.md
index 464f21eb..fff99cb9 100644
--- a/apps/docs/docs/integrations/phonetrack.md
+++ b/apps/docs/docs/integrations/phonetrack.md
@@ -24,7 +24,7 @@ The PhoneTrack template auto-configures the following payload:
```json
{
- "_type": "location",
+ "useragent": "Colota",
"lat": 51.495065,
"lon": -0.043945,
"acc": 12,