Skip to content

Colota - Android GPS Location tracker

docs: clarify notification permission requirement in disclosure modal

Max Dietrich64d7c69e87e7
diff --git a/apps/docs/docs/development/permissions.md b/apps/docs/docs/development/permissions.md
index d336448f..aeb085d9 100644
--- a/apps/docs/docs/development/permissions.md
+++ b/apps/docs/docs/development/permissions.md
@@ -80,7 +80,7 @@ If tracking was active when the device was powered off, Colota automatically res
android.permission.POST_NOTIFICATIONS
```
-Starting with Android 13, apps must request notification permission explicitly. Colota needs this for the foreground service notification. If denied, the service may still run but with reduced reliability depending on the Android version.
+Starting with Android 13, apps must request notification permission explicitly. Colota uses a foreground service for GPS tracking, which requires a persistent notification. Without this permission, the service cannot start - including after a device reboot.
### Local Network Access
diff --git a/apps/docs/docs/getting-started/quick-start.md b/apps/docs/docs/getting-started/quick-start.md
index 5708c8b4..8e4dce20 100644
--- a/apps/docs/docs/getting-started/quick-start.md
+++ b/apps/docs/docs/getting-started/quick-start.md
@@ -8,9 +8,10 @@ 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 (otherwise background tracking won't work reliable)
-4. Press **Start Tracking**
-5. View live coordinates on the dashboard
+3. Grant notification permission - required for the foreground service that keeps GPS tracking alive
+4. Disable battery optimization for Colota in Android settings (otherwise background tracking won't work reliably)
+5. Press **Start Tracking**
+6. View live coordinates on the dashboard
import ScreenshotGallery from '@site/src/components/ScreenshotGallery'
diff --git a/apps/docs/docs/guides/troubleshooting.md b/apps/docs/docs/guides/troubleshooting.md
index 4318286a..5e033c94 100644
--- a/apps/docs/docs/guides/troubleshooting.md
+++ b/apps/docs/docs/guides/troubleshooting.md
@@ -8,7 +8,13 @@ sidebar_position: 4
- Go to **Settings > Apps > Colota > Battery** and select **Unrestricted**
- Verify location permissions are set to **Allow all the time**
-- Ensure the foreground notification is visible
+- Ensure notification permission is granted - Colota uses a foreground service which requires a persistent notification. Without it, the service cannot start.
+
+## Tracking doesn't start after reboot
+
+- Make sure tracking was active before the reboot
+- Notification permission must be granted - without it the foreground service cannot start on boot
+- Disable battery optimization for Colota (**Settings > Apps > Colota > Battery > Unrestricted**)
## GPS accuracy is poor
diff --git a/apps/mobile/src/components/ui/LocationDisclosureModal.tsx b/apps/mobile/src/components/ui/LocationDisclosureModal.tsx
index 556ac4e1..3472188f 100644
--- a/apps/mobile/src/components/ui/LocationDisclosureModal.tsx
+++ b/apps/mobile/src/components/ui/LocationDisclosureModal.tsx
@@ -23,7 +23,7 @@ export function LocationDisclosureModal() {
paragraphs={[
"Colota collects location data to enable GPS tracking and sending your position to your configured server, even when the app is closed or not in use.",
"This data is sent only to the server you set up. No data is shared with third parties.",
- "The app also needs notification and battery permissions to keep tracking running reliably."
+ "The app requires notification permission to show a persistent notification for the foreground service that keeps GPS tracking alive. Battery optimization should be disabled for reliable background operation."
]}
confirmLabel="Agree"
registerCallback={registerDisclosureCallback}