trails-cool/trails
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add mobile app, map-core, nearby sync, and activity recording specs

Browse source 
mobile-app: Unified React Native + Expo app combining Planner and
Journal. OAuth2 PKCE auth, MapLibre maps, versioned REST API with
Zod schemas, configurable server URL, offline SQLite, Web Push relay
notifications. TanStack Query + Zustand state management. Jest +
Maestro testing. 76 tasks across 5 phases.

map-core-package: Extract renderer-agnostic map definitions (tiles,
color palettes, POI categories, z-index) into @trails-cool/map-core.
Pure refactor preparing for MapLibre on mobile. 27 tasks.

mobile-activity-recording: GPS recording, live stats, HealthKit/Health
Connect export. Separated from mobile-app for independent scheduling.

mobile-nearby-sync: BLE route sync between nearby devices for offline
group riding. QR waypoint sharing as simpler v1. TXQR noted as future.

journal-rest-api spec: Full API contract — endpoints, auth, pagination,
errors, discovery, versioning, BRouter proxy.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Ullrich Schäfer 2026-04-12 21:52:30 +02:00
parent e288630a12
commit fff77a2ed2
No known key found for this signature in database
GPG key ID: A32FF691A0F752D9
23 changed files with 996 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

23
openspec/changes/map-core-package/specs/map-core/spec.md Normal file
View file

@ -0,0 +1,23 @@
## ADDED Requirements
### Requirement: Renderer-agnostic map definitions
The `@trails-cool/map-core` package SHALL provide map configuration data usable by any rendering engine.
#### Scenario: Tile source definitions
- **WHEN** a renderer needs tile layer URLs
- **THEN** `map-core` provides base layer and overlay layer configs with URL templates, attribution, and zoom limits
#### Scenario: Route color palettes
- **WHEN** a renderer needs to color a route by surface, highway, grade, or other mode
- **THEN** `map-core` provides the color mapping and color functions for all supported modes
#### Scenario: POI category definitions
- **WHEN** a renderer needs POI icons, colors, and Overpass queries
- **THEN** `map-core` provides the full category configuration
### Requirement: No rendering dependencies
The package SHALL have zero dependencies on any rendering library (Leaflet, MapLibre, React, DOM).
#### Scenario: Import in any environment
- **WHEN** `map-core` is imported in Node.js, a browser, or React Native
- **THEN** it works without errors — no DOM APIs, no rendering side effects