Making it easy to merge map and narrative
JavaScript HTML CSS Other


The odyssey.js library is being developed to help journalists, bloggers, and other people on the web publish stories that combine narratives with maps and map interactions. The library is open source and freely available to use in your projects. It is initially being built to work with most modern browsers.

Build Status


  • Create a simple JavaScript library that links page elements to slippy map interactions
  • Provide an API interface to the JavaScript library that makes use and customization easy
  • Prototype and test multiple map interaction methods for storytelling
  • Develop basic interface for creating new documents using the odyssey.js library


  • Project launched, 23/01/2014
  • Javascript library tested, 17/02/2014
  • Core map actions added, 27/02/2014
  • Designed/added init templates, 11/03/2014
  • Added initial editor, 12/03/2014
  • Added intro docs, 17/03/2014
  • Documentation section, 5/06/2014
  • Updated editor, 10/06/2014
  • Renamed editor => sandbox, 27/06/2014
  • Official release, 9/07/2014

Live sandbox, Documentation and Examples

Jump directly into:


If you are interested in helping us develop the project, see CONTRIBUTING for more information.


Odyssey.js is available under a BSD 3-clause license


Odyssey.js was made possible by a grant from the Knight Foundation.