Merge pull request #254 from trails-cool/docs/park-mobile-specs

Park mobile-activity-recording + mobile-nearby-sync under docs/ideas
This commit is contained in:
Ullrich Schäfer 2026-04-19 08:24:18 +02:00 committed by GitHub
commit 94ce350565
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
8 changed files with 82 additions and 0 deletions

View file

@ -0,0 +1,39 @@
# mobile-activity-recording (parked)
OpenSpec change for recording GPS activities on-device in the mobile app
(ride/hike tracking, live stats, save as Journal activity, HealthKit /
Health Connect export). Moved here from `openspec/changes/` so it does not
clutter the active change list; revive by moving the directory back under
`openspec/changes/` when ready to implement.
## Status
**Parked.** Blocked on `mobile-app` (the foundation change) landing first,
and on there being enough Journal users actually logging activities to
justify the native-recording complexity. At the current user count (3) and
activity count (0), shipping this would be writing code for nobody.
## When to revive
Revisit once **any** of these is true:
- The mobile app is live and users are asking to record from the phone
instead of importing from Wahoo/Garmin/Komoot later
- The web Journal has a meaningful stream of imported activities, so the
feature lands into an existing behaviour rather than inventing one
- A specific user request justifies the iOS/Android background-location
privacy review (App Store's bar for background GPS is high)
## Key constraints to remember
- **Background GPS requires explicit user consent + justification** on iOS
and Android. App Store privacy review will scrutinise this.
- **Dependencies**: `expo-location` for the track, plus `expo-health` (or
equivalent) for HealthKit / Health Connect integration.
- **Battery**: continuous GPS at high accuracy is a power-hungry path;
recording UI needs clear on/off state and resumption.
## What's in the folder
- `proposal.md` — why / what / impact
- `specs/` — delta specs (would land against a new `mobile-activity-recording` capability)

View file

@ -0,0 +1,43 @@
# mobile-nearby-sync (parked)
OpenSpec change for sharing routes between nearby devices without internet
(BLE-based peer sync + QR-code waypoint fallback) in the mobile app.
Moved here from `openspec/changes/` so it does not clutter the active
change list; revive by moving the directory back under
`openspec/changes/` when ready to implement.
## Status
**Parked.** Blocked on `mobile-app` landing first, and on there being
enough users actually hiking/bikepacking together to justify the BLE
complexity. At the current user count (3) this is engineering for a
hypothetical group trip.
## When to revive
Revisit once **any** of these is true:
- The mobile app is live and users start reporting "we were in a dead zone
and couldn't update the route"
- A group / tour organiser asks specifically for peer-to-peer route sync
- QR-code waypoint sharing alone (the simpler half of this spec) would
cover the need — worth shipping that first as a narrower change
## Key constraints to remember
- **Requires an Expo dev build**`react-native-ble-plx` isn't available
in Expo Go.
- **iOS + Android BLE APIs differ significantly**; expect platform-specific
bugs. Background BLE advertising has battery and OS-lifecycle caveats
(iOS suspends advertising when backgrounded after a grace period).
- **Permissions sprawl**: iOS `NSBluetoothAlwaysUsageDescription`, Android
`BLUETOOTH_SCAN` + `BLUETOOTH_CONNECT` + `BLUETOOTH_ADVERTISE`, plus
location on older Android.
- **QR waypoint sharing is an order of magnitude simpler** than BLE and
covers a big chunk of the use case — consider extracting that as a
separate, earlier change if the need becomes real.
## What's in the folder
- `proposal.md` — why / what / non-goals / impact / future ideas (TXQR)
- `specs/` — delta specs (would land against a new `mobile-nearby-sync` capability)