Making it easy to merge map and narrative
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist update dist files Dec 11, 2014
examples start of border project with @lauraguzman Apr 11, 2014
lib/odyssey fixes setting current state Dec 5, 2014
sandbox added missing l in locahost Dec 2, 2014
test fixed problem with async tasks being sync Jun 6, 2014
vendor Merge branch 'master' into anim Jun 11, 2014
.gitignore remove _site Jun 2, 2014
.travis.yml updated travis file May 28, 2014 wip Feb 13, 2014 Typo Stories Jul 15, 2014
LICENSE doh, spelling error Jan 23, 2014 added more status details Mar 30, 2014
Makefile missing editor => sandbox Jun 27, 2014
package.json added gestures module Jun 9, 2014


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.