Colota - Android GPS Location tracker
docs: add alternatives page, integrations overview and FAQ improvements
Max Dietriche87cfefead83
diff --git a/apps/docs/docs/alternatives.md b/apps/docs/docs/alternatives.mdnew file mode 100644index 00000000..1287d15a--- /dev/null+++ b/apps/docs/docs/alternatives.md@@ -0,0 +1,35 @@+---+sidebar_position: 2+---++# Alternatives++Colota is one of several Android apps that can record and forward GPS location data. This page gives an honest overview of the options so you can pick the right tool.++## Comparison++| | Colota | OwnTracks | GPSLogger | Traccar Client | μLogger |+| -------------------------------------- | :----: | :-------: | :-------: | :------------: | :-----: |+| In-app location history & trip view | ✓ | – | – | – | – |+| File export (GPX, KML, CSV…) | ✓ | – | ✓ | – | ✓ |+| Scheduled auto-export | ✓ | – | – | – | – |+| Waypoints / notes | – | – | ✓ | – | ✓ |+| Geofencing (pause zones) | ✓ | – | – | – | – |+| Automatic condition-based profiles | ✓ | – | – | – | – |+| Offline maps | ✓ | – | – | – | – |+| Built-in server integrations | ✓ | – | – | – | – |+| MQTT support | – | ✓ | – | – | – |+| FOSS variant (no Google Play Services) | ✓ | ✓ | ✓ | – | ✓ |+| iOS app available | – | ✓ | – | ✓ | – |++## When to use each++**Colota** is a good fit if you want a self-hosted tracking app with location history, geofencing, and backend flexibility - and you want to see and manage your data inside the app itself.++**[OwnTracks](https://owntracks.org)** is a better fit if you need MQTT support. It has both Android and iOS clients, making it the natural choice for mixed-platform households.++**[GPSLogger](https://gpslogger.app)** is a better fit if your goal is a GPX, KML, or CSV file rather than a live server sync - for hiking, geotagging photos, or recording routes. It can also upload directly to Dropbox, Google Drive, FTP, and OpenStreetMap.++**[Traccar Client](https://www.traccar.org/client/)** is a better fit if you exclusively use Traccar and want the simplest possible client with no extra features.++**[μLogger](https://github.com/bfabiszewski/ulogger-android)** is a better fit if you want a lightweight logger with waypoint support (photos and notes attached to locations) and you self-host the matching [uLogger server](https://github.com/bfabiszewski/ulogger-server).diff --git a/apps/docs/docs/faq.md b/apps/docs/docs/faq.mdindex 1bbfb9af..494d9001 100644--- a/apps/docs/docs/faq.md+++ b/apps/docs/docs/faq.md@@ -48,6 +48,18 @@ If auto-start on boot is enabled, Colota automatically resumes tracking after aDepends on your settings. With the **Balanced** preset (30s interval, batch sync), typical usage is moderate. See [Battery Optimization](/docs/guides/battery-optimization) for tips.+### How do I update the app?++- **Google Play** - updates automatically, or open the Play Store and tap Update+- **IzzyOnDroid** - open the IzzyOnDroid client and update from there, or use [Obtainium](https://github.com/ImranR98/Obtainium) to track releases automatically+- **GitHub Releases** - download the latest APK from [GitHub Releases](https://github.com/dietrichmax/colota/releases) and install it - Android will update the existing app in place++### Is there an iOS version?++No, and none is currently planned. The UI is React Native, but the core of the app - background location tracking, the foreground service, geofencing, and sync scheduling - is all native Android Kotlin code that would need to be rewritten from scratch for iOS. Beyond the technical effort, Apple's developer account costs 100 EUR/year, maintaining two platforms would significantly increase the ongoing work, and testing without a real iPhone would be impractical.++If an iOS version were ever built, it would realistically need to be a paid app to offset the cost and effort - which would shift this from a hobby project into something with different expectations. It's not off the table forever, but there are no concrete plans.+### What Android versions are supported?Colota requires Android 8.0 (API 26) or higher.diff --git a/apps/docs/docs/getting-started/quick-start.md b/apps/docs/docs/getting-started/quick-start.mdindex e54b991c..5708c8b4 100644--- a/apps/docs/docs/getting-started/quick-start.md+++ b/apps/docs/docs/getting-started/quick-start.md@@ -8,7 +8,7 @@ Minimal setup to start tracking:1. Install the app ([Google Play](https://play.google.com/store/apps/details?id=com.Colota&hl=en-US), [IzzyOnDroid](https://apt.izzysoft.de/packages/com.Colota/), or [APK](https://github.com/dietrichmax/colota/releases))2. Grant location permissions - select **Precise location** and **Allow all the time**-3. Disable battery optimization for Colota in Android settings+3. Disable battery optimization for Colota in Android settings (otherwise background tracking won't work reliable)4. Press **Start Tracking**5. View live coordinates on the dashboard@@ -23,3 +23,4 @@ The app works completely offline. Server setup is optional.- [Configure GPS settings](/docs/configuration/gps-settings) to adjust tracking intervals- [Set up a server](/docs/configuration/server-settings) to sync location data- [Create geofences](/docs/guides/geofencing) to save battery at home or work+- [Battery optimization tips](/docs/guides/battery-optimization) to reduce power usagediff --git a/apps/docs/docs/integrations/overview.md b/apps/docs/docs/integrations/overview.mdnew file mode 100644index 00000000..d19b8111--- /dev/null+++ b/apps/docs/docs/integrations/overview.md@@ -0,0 +1,33 @@+---+sidebar_position: 1+---++# Choosing a Backend++Colota sends location data to a server you control. If you're not sure which backend to use, this page gives a quick comparison.++## Comparison++| Backend | Best for |+| ----------------------------------- | --------------------------------------------------------------------------- |+| [Dawarich](dawarich.md) | Location history, map visualization, stats and trip analysis |+| [GeoPulse](geopulse.md) | Location tracking with trip visualization and timeline |+| [Home Assistant](home-assistant.md) | Home automation - use location as a trigger for automations and zones |+| [OwnTracks](owntracks.md) | Self-hosted location history using the OwnTracks Recorder |+| [Reitti](reitti.md) | Location history with automatic visit and trip detection and daily timeline |+| [PhoneTrack](phonetrack.md) | Track devices from within an existing Nextcloud install |+| [Traccar](traccar.md) | Real-time GPS tracking platform for multiple devices and fleet management |+| [Custom Backend](custom-backend.md) | Any HTTP endpoint - configure field names and format to match your API |++## Quick decision guide++- **I want to visualize my location history with maps and stats** - use [Dawarich](dawarich.md) or [GeoPulse](geopulse.md)+- **I use Home Assistant for home automation** - use [Home Assistant](home-assistant.md)+- **I already run Nextcloud** - use [PhoneTrack](phonetrack.md)+- **I need to track multiple devices** - use [Traccar](traccar.md)+- **I want to send to my own API** - use [Custom Backend](custom-backend.md)+- **I want to send to multiple backends at once** - point Colota at [colota-forwarder](https://github.com/dietrichmax/colota-forwarder) and configure each target there++## No backend needed++Colota works fully offline without any server. Locations are stored on-device and can be exported as CSV, GeoJSON, GPX, or KML at any time.diff --git a/apps/docs/docs/integrations/reitti.md b/apps/docs/docs/integrations/reitti.mdindex c4c83443..463bb658 100644--- a/apps/docs/docs/integrations/reitti.md+++ b/apps/docs/docs/integrations/reitti.md@@ -4,11 +4,11 @@ sidebar_position: 4# Reitti-[Reitti](https://github.com/Moo-Ack-Productions/reitti) is a self-hosted location tracking service.+[Reitti](https://github.com/dedicatedcode/reitti) is a self-hosted location tracking service.## Setup-1. **Install Reitti** - follow the [Reitti documentation](https://github.com/Moo-Ack-Productions/reitti)+1. **Install Reitti** - follow the [Reitti documentation](https://www.dedicatedcode.com/projects/reitti/)2. **Configure Colota**:- Go to **Settings > API Settings**- Select the **Reitti** templatediff --git a/apps/docs/sidebars.ts b/apps/docs/sidebars.tsindex 1bfe31ba..6ef020d7 100644--- a/apps/docs/sidebars.ts+++ b/apps/docs/sidebars.ts@@ -27,6 +27,7 @@ const sidebars: SidebarsConfig = {type: "category",label: "Integrations",items: [+ "integrations/overview","integrations/api-templates","integrations/dawarich","integrations/home-assistant",@@ -54,6 +55,11 @@ const sidebars: SidebarsConfig = {"guides/troubleshooting"]},+ {+ type: "doc",+ id: "alternatives",+ label: "Alternatives"+ },{type: "category",label: "Development",