trails-cool/trails
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trails/openspec/changes/map-core-package/tasks.md
Ullrich Schäfer fff77a2ed2
Add mobile app, map-core, nearby sync, and activity recording specs 
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>
2026-04-12 21:52:30 +02:00

2.5 KiB
Raw Blame History

1. Package Setup

  • 1.1 Create packages/map-core/ with package.json, tsconfig.json, add to pnpm workspace and Turborepo pipeline
  • 1.2 Create src/index.ts with re-exports for all modules

2. Tile Definitions

  • 2.1 Move baseLayers and TileLayerConfig from packages/map/src/layers.ts to packages/map-core/src/tiles.ts
  • 2.2 Move overlayLayers and OverlayLayerConfig to packages/map-core/src/tiles.ts
  • 2.3 Update packages/map/src/layers.ts to re-export from @trails-cool/map-core
  • 2.4 Update packages/map/src/index.ts exports

3. Color Palettes

  • 3.1 Extract SURFACE_COLORS, DEFAULT_SURFACE_COLOR from ColoredRoute.tsx to map-core/src/colors/surface.ts
  • 3.2 Extract HIGHWAY_COLORS, DEFAULT_HIGHWAY_COLOR to map-core/src/colors/highway.ts
  • 3.3 Extract SMOOTHNESS_COLORS, DEFAULT_SMOOTHNESS_COLOR to map-core/src/colors/smoothness.ts
  • 3.4 Extract TRACKTYPE_COLORS, DEFAULT_TRACKTYPE_COLOR to map-core/src/colors/tracktype.ts
  • 3.5 Extract CYCLEWAY_COLORS, DEFAULT_CYCLEWAY_COLOR to map-core/src/colors/cycleway.ts
  • 3.6 Extract BIKEROUTE_COLORS, DEFAULT_BIKEROUTE_COLOR to map-core/src/colors/bikeroute.ts
  • 3.7 Extract elevationColor(), routeGradeColor() to map-core/src/colors/elevation.ts
  • 3.8 Extract maxspeedColor() to map-core/src/colors/maxspeed.ts
  • 3.9 Create map-core/src/colors/index.ts re-exporting all color maps and functions
  • 3.10 Update ColoredRoute.tsx to import from @trails-cool/map-core
  • 3.11 Update ElevationChart.tsx to import from @trails-cool/map-core

4. POI Categories

  • 4.1 Move PoiCategory type and poiCategories array from poi-categories.ts to map-core/src/poi.ts
  • 4.2 Move getCategoriesForProfile() and profileOverlayDefaults to map-core/src/poi.ts
  • 4.3 Update Planner imports: PoiPanel.tsx, use-pois.ts, use-profile-defaults.ts, poi-categories.test.ts
  • 4.4 Move POI snap distance constant to map-core/src/snap.ts

5. Z-Index Constants

  • 5.1 Move all z-index constants from z-index.ts to map-core/src/z-index.ts
  • 5.2 Update Planner imports: PlannerMap.tsx, PoiPanel.tsx, RouteInteraction.tsx

6. Verification

  • 6.1 Run pnpm typecheck — all packages compile
  • 6.2 Run pnpm lint — no import errors
  • 6.3 Run pnpm test — all existing tests pass (update import paths in test files)
  • 6.4 Run pnpm test:e2e — no regressions
  • 6.5 Verify map-core has zero dependencies in its package.json