MapStory is the free atlas of change that everyone can edit
Python HTML JavaScript CSS Shell Dockerfile Other
Clone or download
Failed to load latest commit information.
.tx Update tx config Mar 7, 2016
deps Update story-tools-composer Aug 10, 2018
docker Update docker version in host provision script Aug 11, 2018
mapstory Ensure that ACCOUNT_OPEN_SIGNUP and ENABLE_FORM_LOGIN are both True b… Aug 3, 2018
scripts Switch to straight Selenium for local tests Nov 21, 2017
.coveragerc Attempt at fixing the ignore list for test coverage Jul 21, 2017
.dockerignore GeoAxis Integration for geonode 2.8.0 baseline (#1438) Jun 19, 2018
.eslintrc Fixed spaces and double quotes May 26, 2018
.gitattributes Update .gitattributes file. Mar 21, 2018
.gitignore Adds basic audit logging app that tracks user login / logout and the … Jul 16, 2018
.gitmodules Base upgrade that updates the submodule to geonode 2.8.0. Jun 1, 2018
.travis.yml Revert "Debug statement for TravisCI" Jun 12, 2018
Dockerfile GeoAxis Integration for geonode 2.8.0 baseline (#1438) Jun 19, 2018
Dockerfile.protractor Set up acceptance tests (#1102) Nov 14, 2017
LICENSE.txt Create LICENSE.txt Aug 10, 2018 Update May 1, 2018
docker-compose.override.yml Alpinify postgres May 12, 2018
docker-compose.yml Update to GeoServer 2.12.4 with new OAUTH2 config Aug 1, 2018
epsg_extra Remove old, outdated scripts that are no longer in use with the Docke… Jul 26, 2017 Our bower packages (mostly story-tools) were not always being updated… Apr 26, 2017 Fixed google analytics tests to work with freshly provisioned local_s… Jan 9, 2017
paster.ini paster serves assets, note in settings Apr 28, 2015 Consolidate static assets using a theme directory convention. #1190 May 25, 2016
requirements.txt change pillow version to 5.1.0 (required for animated gif) Aug 3, 2018 Refactor Mapstories + Storyframes + Storypins Apps (#1189) Feb 6, 2018


Coverage Status Build Status Build Status

Build Status is the free atlas of change that everyone can edit. We are a community, not a company, working to organize humanity’s shared knowledge about how the world evolves geographically over time, and to make this knowledge easily accessible as an open educational resource.

The MapStory community’s work breaks down into 3 big tasks. We call them the “3 Cs”. First, once you’ve created a profile, you can collect spatio-temporal data and import it. We call each dataset imported into a “StoryLayer”. Second you can compose MapStories that provide nuanced understanding of historical change by combining StoryLayers and other narrative elements, like images, text, or video. Finally, you can curate the accuracy and quality of content presented in by adding ratings, checking metadata, making comments and committing version edits to the actual StoryLayers themselves, much like you might edit a Wikipedia page.

Getting Started


This guide assumes you are using a UNIX based operating system such as Linux or OSX and have the below installed.


Setup a Development Environment

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. Start by forking the mapstory repository to your own Github account, and then cloning that repository to your local development environment.

git clone<your-username>/mapstory

Add the following to your /etc/hosts file       docker
::1             docker

Run the following commands to start up the docker containers.

git submodule update --init --recursive
docker-compose pull
docker-compose up -d

Your local site should now be available at http://docker/.

Additional information about using the docker build is available at our Docker README.

Built With


Please read How to Contribute for details on our code of conduct, and the process for submitting pull requests to us.

Styleguides & Best Practices

Please review our Contributor Guides for best practices and style guides before contributing to the project.