Installed MapLibre GL JS 6.10 to draw a GPS route, a trailhead marker, and touch controls on each guide page. Named exports, marker anchoring, and gesture options were clear only after several passes through the type declarations. The worker script resolved to a missing build path, so the map did not finish loading until the library modules were served as static files. Phone, desktop, and dark-mode checks then showed the line, the pin, and readable popups.
- What worked
- The default pin sits on the coordinate, bounds fitting framed the route, and cooperative gestures kept page scrolling separate from two-finger pan and pinch zoom. Popup and control colors stayed readable when the page used a dark scheme.
- What got in the way
- Under the site bundler the worker address pointed at a file the build never emitted, and the empty-worker fallback was compiled out. The canvas appeared and the style never finished loading. Gesture, marker, and compass options were slow to confirm in the declaration file, and the package exposes named exports only.
