Troubleshooting

Common issues and how to resolve them.

No Points Recording

You've started tracking but the point count stays at 0 or increases very slowly.

Check location permission: Go to iOS Settings → Privacy & Security → Location Services → Poreia. Make sure it's set to "While Using" or "Always".
Check GPS signal: The accuracy indicator on the main screen shows current GPS quality. Indoors or in urban canyons, GPS may be poor.
Check accuracy filter: If set too strict (e.g., 10m) in poor conditions, points will be filtered out. Try Settings → Poreia → Tracking → Accuracy Filter → 50m or Off.

Tracking works while the app is open, but stops when you switch apps or lock your screen.

Grant "Always" permission: Go to iOS Settings → Privacy & Security → Location Services → Poreia → Always.
Check for Low Power Mode: In Low Power Mode, background updates are reduced to ~100m intervals. Your track will still record, but with fewer points.

The track has fewer points than expected, with gaps between them.

Check Low Power Mode: When enabled, GPS updates drop to ~100m intervals. Turn off Low Power Mode for detailed tracking.
Check Travel Speed setting: Settings → Poreia → Tracking → Travel Speed. "High" mode records less frequently. Try "Auto" or "Low" for walking.
Check Accuracy Filter: A strict filter (10m, 25m) discards points with poor GPS. Try 50m or Off.

You start tracking but don't see the Live Activity on Lock Screen or Dynamic Island.

Check notification permission: iOS Settings → Poreia → Notifications → Allow Notifications
Check Live Activities setting: iOS Settings → Poreia → Live Activities (toggle on)
Check Lock Screen access: iOS Settings → Face ID & Passcode → Allow Access When Locked → Live Activities
Restart tracking: Stop and start a new track after changing settings

The widget shows "Not Tracking" when you're actually tracking, or shows stale data.

Open the app: Widget state syncs when the app enters background. Open Poreia briefly, then return to Home Screen.
Wait for refresh: iOS limits widget updates. The widget will sync within 30 seconds during active tracking.
Remove and re-add: If the widget seems stuck, remove it from Home Screen and add a new one.

Siri says it can't find that shortcut or doesn't respond to Poreia commands.

Enable Siri Shortcuts: The first time you use a command, iOS prompts to enable shortcuts for Poreia. Make sure you tap "Turn On".
Use exact phrases: Try "Hey Siri, start tracking in Poreia" with the app name.
Check Siri settings: iOS Settings → Siri & Search → Poreia → Show in Siri

The app crashed during tracking and your data seems lost.

Check for recovery prompt: On next launch, Poreia should offer to restore your session. Tap "Restore" to recover.
Check Recently Deleted: If you accidentally discarded a track, check Saved Tracks → Recently Deleted.

For persistent issues, enable debug logging to capture detailed information:

If these steps don't resolve your issue: