Storymaps

Page content:

A storymap tells a story in steps beside a map. The map stays in view while the reader scrolls, and moves to each step as it comes up: to a place, to the part of a journey the step is about, or to the layers it explains. The steps are ordinary Markdown, so the story still reads as a page without the map.

Docked The steps beside the map, in a page like any other. A storymap is docked unless it says otherwise.
Floating The map fills the storymap, and the steps scroll over it as cards.
A story page A page of its own, where the map fills the window.
  1. 1The steps are ordinary Markdown. The one the reader has scrolled to is the active step.
  2. 2The map stays in view, and moves to what the active step is about.

See one

  • A saildrone in the Pacific follows a NOAA sailing drone for five months on a globe. Its track draws itself as you scroll, a marker sails at its head, and the sixth step colours it by the temperature of the sea.
  • The Postdoc story has no map at all: a picture stays in view for each step, beside the commands you'd run.

Write one

  • Your first storymap goes from an empty page to a map that flies between three harbours, in four short steps.
  • Story pages puts a story on a page of its own, where the map fills the window.
  • Mapping a mission is for people who work with geospatial data. It builds the saildrone story from a public dataset: tiles, time, data-driven colours, a legend and a readout under the pointer.
  • The reference lists every attribute and setting.

What a storymap can do

It has What that means
Views A place and a zoom, or an area to fit. The map can turn and tilt, and each move can take as long as the story needs.
Time Layers that hold a time show up to the moment a step has reached, so a track grows from step to step, with a marker at its head.
Layers A step shows or hides layers. Their colours can follow the data, with a legend that appears when they do.
Readouts Point at a feature to read its properties.
Base maps Any MapLibre style: vector or raster tiles, a WMS, or a single PMTiles file, on a flat map or a globe.
Pictures A picture for each step instead of a map, with no map code loaded.
Layouts Docked beside the text of a page, floating over a map that fills the storymap, or on a page of its own.

For every reader

  • The steps are the story. Without JavaScript or WebGL, or with a screen reader, they read as an ordinary page.
  • The map is named after the step it shows. Its zoom buttons and the arrow keys work with the keyboard.
  • Scrolling the page doesn't zoom the map. That takes Ctrl and the scroll wheel, or two fingers.
  • With reduced motion turned on, the map jumps to each step instead of flying there, the timeline shows each step's time at once, and pictures change without fading.
  • What a readout or a legend shows is extra. Say what matters in the step as well.

The map is drawn with MapLibre, which Postdoc loads, with PMTiles when a source needs it, only on pages that have a storymap with a map.

Edit this page on GitHub