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.mdindex 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 Headersdiff --git a/apps/docs/docs/configuration/gps-settings.md b/apps/docs/docs/configuration/gps-settings.mdindex 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 theWhen 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.mdindex 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 Componentsdiff --git a/apps/docs/docs/development/local-setup.md b/apps/docs/docs/development/local-setup.mdindex 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 check2. 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 ScreenshotsApp 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.mdindex 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.mdindex 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 bundlernpm 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.mdindex 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.mdindex 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 syncHTTPS 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.mdindex 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,