About the Project

This project began with selecting an inspirational image, a historic flow map by Charles Joseph Minard, to guide the colour palette and establish the visual tone of the basemap. The result is an interactive web map built with Mapbox GL JS and Mapbox Studio that showcases major ports worldwide while providing key contextual information through an intuitive design.

Inspiration image: Charles Joseph Minard’s 1869 flow map illustrating European raw cotton imports before, during, and after the American Civil War.
Inspirational Image: Charles Joseph Minard’s 1869 flow map illustrating European raw cotton imports before, during, and after the American Civil War.

A key component of the project was popup design. Hovering over a port name displays a condensed popup with quick contextual information, while clicking opens an expanded popup with more detailed information, along with interactive controls to zoom directly to the selected port and return to the previous zoom extent.

Interactive Mapbox GL JS application visualizing worldwide ports and global shipping routes.
Interactive worldwide ports application developed using Mapbox GL JS, custom vector tiles, and responsive popup interactions.

Dashed lines connecting the ports, representing global shipping lanes, were added to the map as a custom vector layer created with the Mapbox Tiling Service (MTS) via the Mapbox Command Line Interface (CLI). Unlike with the default Mapbox Studio interface, this approach provided complete control over zoom based generalization.

Interactive Mapbox GL JS application visualizing worldwide ports and global shipping routes.
Zoomed in view of the Port of Kawasaki, showing minimal pop-up.

Technology Stack

  • HTML
  • CSS
  • JavaScript
  • Mapbox GL JS
  • Mapbox Studio
  • Mapbox CLI
  • Mapbox Tiling Service (MTS)

Applied Skills

  • Designed and implemented multi-state popup interactions using hover and click event logic.
  • Processed and deployed custom vector tiles with the Mapbox Tiling Service and Mapbox CLI.
  • Developed responsive interactive web mapping workflows using Mapbox GL JS.
  • Applied historically informed cartographic styling principles to establish visual hierarchy.
  • Managed scale-dependent feature behaviour to maintain clarity across zoom levels.
↑ Back to top