trails-cool/trails
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trails/openspec/changes/archive/2026-06-12-journal-elevation-profile/proposal.md
Ullrich Schäfer f1cae13605
openspec: archive the detail catch-up changes, sync specs 
Archive the three implemented + merged changes (activity-sport-type,
activity-stats, journal-elevation-profile): their deltas are promoted into
openspec/specs/, the changes move to changes/archive/2026-06-12-*, and the
three new capabilities are added to the CAPABILITIES index.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-12 15:58:17 +02:00

2.3 KiB
Raw Blame History

Why

The Journal's route and activity detail pages show elevation only as two numbers (gain/loss) even though the full elevation series is already parsed from the GPX. Both Komoot and Strava treat the elevation profile as the second hero object after the map, and the interaction that makes a route feel "inspectable" — hovering the profile to move a marker on the map, and vice-versa — is the single most satisfying detail-page feature. We already have this interaction specced and built on the Planner (elevation-map-interaction); this change ports a read-only version to the Journal detail pages.

What Changes

  • Render an elevation profile chart on the route detail and activity detail pages: a gradient-filled area chart (x = distance, y = elevation) with a summary strip (ascent · descent · highest · lowest).
  • Add a shared "active distance" interaction: hovering the chart highlights the corresponding point on the Leaflet map (a marker), and hovering the route line highlights the corresponding position on the chart. Both stay in sync.
  • Clicking a point on the chart centers the map on that location (read-only — no editing, unlike the Planner).
  • Degrade gracefully: when the GPX has no usable elevation series, the chart is omitted (the gain/loss numbers remain).

Capabilities

New Capabilities

  • journal-elevation-profile: the elevation profile chart and the chart↔map "active distance" interaction on the Journal's read-only route and activity detail pages.

Modified Capabilities

Impact

  • Journal app: a new ElevationProfile chart component, a shared "active distance" state lifted over the detail page's map + chart, and wiring in routes.$id.tsx and activities.$id.tsx. Loaders expose the elevation series (derived from existing gpx).
  • Packages: reuse @trails-cool/gpx for the elevation/distance series and @trails-cool/map-core for the elevation color scale; no new dependency.
  • i18n: journal.elevation.* keys (en + de) for the summary labels.
  • No schema or wire-contract change.